Skip to content

Commit 8b316b6

Browse files
committed
Query: Update documentation for different ctors of SqlExpression
Resolves #21404
1 parent 4795eee commit 8b316b6

File tree

3 files changed

+12
-12
lines changed

3 files changed

+12
-12
lines changed

src/EFCore.Relational/Query/SqlExpressions/CaseExpression.cs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ public class CaseExpression : SqlExpression
2424
private readonly List<CaseWhenClause> _whenClauses = new List<CaseWhenClause>();
2525

2626
/// <summary>
27-
/// Creates a new instance of the <see cref="CaseExpression" /> class.
27+
/// Creates a new instance of the <see cref="CaseExpression" /> class which represents a simple CASE expression.
2828
/// </summary>
2929
/// <param name="operand"> An expression to compare with <see cref="CaseWhenClause.Test"/> in <see cref="WhenClauses"/>. </param>
3030
/// <param name="whenClauses"> A list of <see cref="CaseWhenClause"/> to compare and get result from. </param>
@@ -43,7 +43,7 @@ public CaseExpression(
4343
}
4444

4545
/// <summary>
46-
/// Creates a new instance of the <see cref="CaseExpression" /> class.
46+
/// Creates a new instance of the <see cref="CaseExpression" /> class which represents a searched CASE expression.
4747
/// </summary>
4848
/// <param name="whenClauses"> A list of <see cref="CaseWhenClause"/> to evaluate condition and get result from. </param>
4949
/// <param name="elseResult"> A value to return if no <see cref="WhenClauses"/> matches, if any. </param>

src/EFCore.Relational/Query/SqlExpressions/InExpression.cs

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ namespace Microsoft.EntityFrameworkCore.Query.SqlExpressions
2323
public class InExpression : SqlExpression
2424
{
2525
/// <summary>
26-
/// Creates a new instance of the <see cref="InExpression" /> class.
26+
/// Creates a new instance of the <see cref="InExpression" /> class which represents a <paramref name="item"/> IN subquery expression.
2727
/// </summary>
2828
/// <param name="item"> An item to look into values. </param>
2929
/// <param name="negated"> A value indicating if the item should be present in the values or absent. </param>
@@ -40,7 +40,7 @@ public InExpression(
4040
}
4141

4242
/// <summary>
43-
/// Creates a new instance of the <see cref="InExpression" /> class.
43+
/// Creates a new instance of the <see cref="InExpression" /> class which represents a <paramref name="item"/> IN values expression.
4444
/// </summary>
4545
/// <param name="item"> An item to look into values. </param>
4646
/// <param name="negated"> A value indicating if the item should be present in the values or absent. </param>
@@ -57,7 +57,7 @@ public InExpression(
5757
}
5858

5959
/// <summary>
60-
/// Creates a new instance of the <see cref="InExpression" /> class.
60+
/// Creates a new instance of the <see cref="InExpression" /> class which represents a <paramref name="item"/> IN subquery expression.
6161
/// </summary>
6262
/// <param name="item"> An item to look into values. </param>
6363
/// <param name="subquery"> A subquery in which item is searched. </param>
@@ -73,7 +73,7 @@ public InExpression(
7373
}
7474

7575
/// <summary>
76-
/// Creates a new instance of the <see cref="InExpression" /> class.
76+
/// Creates a new instance of the <see cref="InExpression" /> class which represents a <paramref name="item"/> IN values expression.
7777
/// </summary>
7878
/// <param name="item"> An item to look into values. </param>
7979
/// <param name="values"> A list of values in which item is searched. </param>

src/EFCore.Relational/Query/SqlExpressions/SqlFunctionExpression.cs

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ namespace Microsoft.EntityFrameworkCore.Query.SqlExpressions
2424
public class SqlFunctionExpression : SqlExpression
2525
{
2626
/// <summary>
27-
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class.
27+
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class which represents a built-in niladic function.
2828
/// </summary>
2929
/// <param name="functionName"> The name of the function. </param>
3030
/// <param name="nullable"> A bool value indicating whether this function can return null. </param>
@@ -40,7 +40,7 @@ public SqlFunctionExpression(
4040
}
4141

4242
/// <summary>
43-
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class.
43+
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class which represents a niladic function.
4444
/// </summary>
4545
/// <param name="schema"> The schema in which the function is defined. </param>
4646
/// <param name="functionName"> The name of the function. </param>
@@ -58,7 +58,7 @@ public SqlFunctionExpression(
5858
}
5959

6060
/// <summary>
61-
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class.
61+
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class which represents a niladic function which is invoked on an instance.
6262
/// </summary>
6363
/// <param name="instance"> An expression on which the function is defined. </param>
6464
/// <param name="functionName"> The name of the function. </param>
@@ -91,7 +91,7 @@ private SqlFunctionExpression(
9191
}
9292

9393
/// <summary>
94-
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class.
94+
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class which represents a built-in function.
9595
/// </summary>
9696
/// <param name="functionName"> The name of the function. </param>
9797
/// <param name="arguments"> The arguments of the function. </param>
@@ -111,7 +111,7 @@ public SqlFunctionExpression(
111111
}
112112

113113
/// <summary>
114-
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class.
114+
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class which represents a function.
115115
/// </summary>
116116
/// <param name="schema"> The schema in which the function is defined. </param>
117117
/// <param name="functionName"> The name of the function. </param>
@@ -133,7 +133,7 @@ public SqlFunctionExpression(
133133
}
134134

135135
/// <summary>
136-
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class.
136+
/// Creates a new instance of the <see cref="SqlFunctionExpression" /> class which represents a function which is invoked on an instance.
137137
/// </summary>
138138
/// <param name="instance"> An expression on which the function is applied. </param>
139139
/// <param name="functionName"> The name of the function. </param>

0 commit comments

Comments
 (0)