You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Dec 24, 2022. It is now read-only.
/// <summary>Extracts a scalar value from a JSON string.</summary>
91
+
/// <param name="expression">
92
+
/// An expression. Typically the name of a variable or a column that contains JSON text.<br/><br/>
93
+
/// If <b>JSON_VALUE</b> finds JSON that is not valid in expression before it finds the value identified by <i>path</i>, the function returns an error. If <b>JSON_VALUE</b> doesn't find the value identified by <i>path</i>, it scans the entire text and returns an error if it finds JSON that is not valid anywhere in <i>expression</i>.
94
+
/// </param>
95
+
/// <param name="path">
96
+
/// A JSON path that specifies the property to extract. For more info, see <see cref="https://docs.microsoft.com/en-us/sql/relational-databases/json/json-path-expressions-sql-server">JSON Path Expressions (SQL Server)</see>.<br/><br/>
97
+
/// In SQL Server 2017 and in Azure SQL Database, you can provide a variable as the value of <i>path</i>.<br/><br/>
98
+
/// If the format of path isn't valid, <b>JSON_VALUE</b> returns an error.<br/><br/>
99
+
/// </param>
100
+
/// <returns>
101
+
/// Returns a single text value of type nvarchar(4000). The collation of the returned value is the same as the collation of the input expression.
102
+
/// If the value is greater than 4000 characters: <br/><br/>
/// <li>In strict mode, <b>JSON_VALUE</b> returns an error.</li>
106
+
/// </ul>
107
+
/// <br/>
108
+
/// If you have to return scalar values greater than 4000 characters, use <b>OPENJSON</b> instead of <b>JSON_VALUE</b>. For more info, see <see cref="https://docs.microsoft.com/en-us/sql/t-sql/functions/openjson-transact-sql">OPENJSON (Transact-SQL)</see>.
/// <summary>Extracts a scalar value from a JSON string.</summary>
114
+
/// <param name="expression">
115
+
/// An expression. Typically the name of a variable or a column that contains JSON text.<br/><br/>
116
+
/// If <b>JSON_VALUE</b> finds JSON that is not valid in expression before it finds the value identified by <i>path</i>, the function returns an error. If <b>JSON_VALUE</b> doesn't find the value identified by <i>path</i>, it scans the entire text and returns an error if it finds JSON that is not valid anywhere in <i>expression</i>.
117
+
/// </param>
118
+
/// <param name="path">
119
+
/// A JSON path that specifies the property to extract. For more info, see <see cref="https://docs.microsoft.com/en-us/sql/relational-databases/json/json-path-expressions-sql-server">JSON Path Expressions (SQL Server)</see>.<br/><br/>
120
+
/// In SQL Server 2017 and in Azure SQL Database, you can provide a variable as the value of <i>path</i>.<br/><br/>
121
+
/// If the format of path isn't valid, <b>JSON_VALUE</b> returns an error.<br/><br/>
122
+
/// </param>
123
+
/// <returns>
124
+
/// Returns a single text value of type nvarchar(4000). The collation of the returned value is the same as the collation of the input expression.
125
+
/// If the value is greater than 4000 characters: <br/><br/>
/// <li>In strict mode, <b>JSON_VALUE</b> returns an error.</li>
129
+
/// </ul>
130
+
/// <br/>
131
+
/// If you have to return scalar values greater than 4000 characters, use <b>OPENJSON</b> instead of <b>JSON_VALUE</b>. For more info, see <see cref="https://docs.microsoft.com/en-us/sql/t-sql/functions/openjson-transact-sql">OPENJSON (Transact-SQL)</see>.
/// Extracts an object or an array from a JSON string.<br/><br/>
139
+
/// To extract a scalar value from a JSON string instead of an object or an array, see <see cref="https://docs.microsoft.com/en-us/sql/t-sql/functions/json-value-transact-sql">JSON_VALUE(Transact-SQL)</see>.
140
+
/// For info about the differences between <b>JSON_VALUE</b> and <b>JSON_QUERY</b>, see <see cref="https://docs.microsoft.com/en-us/sql/relational-databases/json/validate-query-and-change-json-data-with-built-in-functions-sql-server#JSONCompare">Compare JSON_VALUE and JSON_QUERY</see>.
141
+
/// </summary>
142
+
/// <typeparam name="T">Type of objects returned</typeparam>
143
+
/// <param name="expression">
144
+
/// An expression. Typically the name of a variable or a column that contains JSON text.<br/><br/>
145
+
/// If <b>JSON_QUERY</b> finds JSON that is not valid in <i>expression</i> before it finds the value identified by <i>path</i>, the function returns an error. If <b>JSON_QUERY</b> doesn't find the value identified by <i>path</i>, it scans the entire text and returns an error if it finds JSON that is not valid anywhere in <i>expression</i>.
146
+
/// </param>
147
+
/// <param name="path">
148
+
/// A JSON path that specifies the object or the array to extract.<br/><br/>
149
+
/// In SQL Server 2017 and in Azure SQL Database, you can provide a variable as the value of <i>path</i>.<br/><br/>
150
+
/// The JSON path can specify lax or strict mode for parsing.If you don't specify the parsing mode, lax mode is the default. For more info, see <see cref="https://docs.microsoft.com/en-us/sql/relational-databases/json/json-path-expressions-sql-server">JSON Path Expressions (SQL Server)</see>.<br/><br/>
151
+
/// The default value for path is '$'. As a result, if you don't provide a value for path, <b>JSON_QUERY</b> returns the input <i>expression</i>.<br/><br/>
152
+
/// If the format of <i>path</i> isn't valid, <b>JSON_QUERY</b> returns an error.
153
+
/// </param>
154
+
/// <returns>
155
+
/// Returns a JSON fragment of type T. The collation of the returned value is the same as the collation of the input expression.<br/><br/>
/// Extracts an object or an array from a JSON string.<br/><br/>
166
+
/// To extract a scalar value from a JSON string instead of an object or an array, see <see cref="https://docs.microsoft.com/en-us/sql/t-sql/functions/json-value-transact-sql">JSON_VALUE(Transact-SQL)</see>.
167
+
/// For info about the differences between <b>JSON_VALUE</b> and <b>JSON_QUERY</b>, see <see cref="https://docs.microsoft.com/en-us/sql/relational-databases/json/validate-query-and-change-json-data-with-built-in-functions-sql-server#JSONCompare">Compare JSON_VALUE and JSON_QUERY</see>.
168
+
/// </summary>
169
+
/// <typeparam name="T">Type of objects returned</typeparam>
170
+
/// <param name="expression">
171
+
/// An expression. Typically the name of a variable or a column that contains JSON text.<br/><br/>
172
+
/// If <b>JSON_QUERY</b> finds JSON that is not valid in <i>expression</i> before it finds the value identified by <i>path</i>, the function returns an error. If <b>JSON_QUERY</b> doesn't find the value identified by <i>path</i>, it scans the entire text and returns an error if it finds JSON that is not valid anywhere in <i>expression</i>.
173
+
/// </param>
174
+
/// <param name="path">
175
+
/// A JSON path that specifies the object or the array to extract.<br/><br/>
176
+
/// In SQL Server 2017 and in Azure SQL Database, you can provide a variable as the value of <i>path</i>.<br/><br/>
177
+
/// The JSON path can specify lax or strict mode for parsing.If you don't specify the parsing mode, lax mode is the default. For more info, see <see cref="https://docs.microsoft.com/en-us/sql/relational-databases/json/json-path-expressions-sql-server">JSON Path Expressions (SQL Server)</see>.<br/><br/>
178
+
/// The default value for path is '$'. As a result, if you don't provide a value for path, <b>JSON_QUERY</b> returns the input <i>expression</i>.<br/><br/>
179
+
/// If the format of <i>path</i> isn't valid, <b>JSON_QUERY</b> returns an error.
180
+
/// </param>
181
+
/// <returns>
182
+
/// Returns a JSON fragment of type T. The collation of the returned value is the same as the collation of the input expression.<br/><br/>
0 commit comments