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 }}
Repository navigation
Commit 3bc51d1
Browse filesBrowse the repository at this point in the historyBrowse files
Review findings: docs and small fixes (reader-level pipeline overloads move the reader on, the older terminals that still ask for SingleResult, the upgrade count, a constant 0 on the SQL commands, DECLARE variables, the lookup remark, one name-check order)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
/// "Not known" is an empty or default array: a procedure name with a database part (the lookup would run in the current database), a provider without the collection,
11
-
/// a procedure the provider does not list, and a name that exists in more than one schema when none was given. A failure of the lookup itself is thrown as it is.
11
+
/// a procedure the provider does not list, and a name that exists in more than one schema when none was given. A failure of the lookup itself is thrown as it is, except that a `NotSupportedException`, a `NotImplementedException` or an `ArgumentException` (and an `InvalidOperationException` that names the collection) is taken as "the provider does not support the collection".
/// Reads an <see cref="IDataReader"/> to the end, posting each record as an array of values to a new <see cref="BufferBlock{T}"/>, and returns the block.
15
15
/// </summary>
16
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
16
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
17
17
/// <param name="options">Options for the returned block, such as its bounded capacity, or <see langword="null"/> for the defaults.</param>
18
18
/// <returns>The block that receives the records. It is completed after the last record has been delivered, or faulted with the exception that ended the reading.</returns>
19
19
/// <remarks>
@@ -35,7 +35,7 @@ public static IReceivableSourceBlock<object[]> AsSourceBlock(this IDataReader re
35
35
/// <summary>
36
36
/// Reads an <see cref="IDataReader"/> to the end, posting each record as an array of values rented from an array pool to a new <see cref="BufferBlock{T}"/>, and returns the block.
37
37
/// </summary>
38
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
38
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
39
39
/// <param name="arrayPool">The array pool to rent each record's array from. The consumer of the records is responsible for returning each array to the pool.</param>
40
40
/// <param name="options">Options for the returned block, such as its bounded capacity, or <see langword="null"/> for the defaults.</param>
41
41
/// <returns>The block that receives the records. It is completed after the last record has been delivered, or faulted with the exception that ended the reading.</returns>
@@ -61,7 +61,7 @@ public static IReceivableSourceBlock<object[]> AsSourceBlock(this IDataReader re
61
61
/// Reads an <see cref="IDataReader"/> to the end, posting each record after it has been transformed by <paramref name="transform"/> to a new <see cref="BufferBlock{T}"/>, and returns the block.
62
62
/// </summary>
63
63
/// <typeparam name="T">The type of the items delivered to the block: the return type of the transform function.</typeparam>
64
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
64
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
65
65
/// <param name="transform">The function that transforms each <see cref="IDataRecord"/> into the item delivered to the block.</param>
66
66
/// <param name="options">Options for the returned block, such as its bounded capacity, or <see langword="null"/> for the defaults.</param>
67
67
/// <returns>The block that receives the records. It is completed after the last record has been delivered, or faulted with the exception that ended the reading.</returns>
@@ -87,7 +87,7 @@ public static IReceivableSourceBlock<T> AsSourceBlock<T>(this IDataReader reader
87
87
/// Reads an <see cref="IDataReader"/> to the end, posting each record mapped to a new instance of <typeparamref name="T"/> to a new <see cref="BufferBlock{T}"/>, and returns the block.
88
88
/// </summary>
89
89
/// <typeparam name="T">The type each record is mapped to.</typeparam>
90
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
90
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
91
91
/// <param name="options">Options for the returned block, such as its bounded capacity, or <see langword="null"/> for the defaults.</param>
92
92
/// <returns>The block that receives the records. It is completed after the last record has been delivered, or faulted with the exception that ended the reading.</returns>
93
93
/// <remarks>
@@ -114,7 +114,7 @@ public static IReceivableSourceBlock<T> AsSourceBlock<T>(this IDataReader reader
114
114
/// Reads an <see cref="IDataReader"/> to the end, posting each record mapped to a new instance of <typeparamref name="T"/> by name, or through <paramref name="map"/> when given, to a new <see cref="BufferBlock{T}"/>, and returns the block.
115
115
/// </summary>
116
116
/// <typeparam name="T">The type each record is mapped to.</typeparam>
117
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
117
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
/// <param name="options">Options for the returned block, such as its bounded capacity, or <see langword="null"/> for the defaults.</param>
120
120
/// <returns>The block that receives the records. It is completed after the last record has been delivered, or faulted with the exception that ended the reading.</returns>
@@ -397,7 +397,7 @@ public static IReceivableSourceBlock<T> AsSourceBlock<T>(this IExecuteReader com
397
397
/// <summary>
398
398
/// Starts reading an <see cref="IDataReader"/> in the background and returns a new <see cref="BufferBlock{T}"/> that receives each record as an array of values as it is read.
399
399
/// </summary>
400
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
400
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
401
401
/// <param name="options">Options for the returned block, such as its bounded capacity, or <see langword="null"/> for the defaults.</param>
402
402
/// <param name="cancellationToken">A token that can cancel the reading. The block is then faulted with the resulting exception.</param>
403
403
/// <returns>The block that receives the records. It is completed after the last record has been delivered, or faulted with the exception that ended the reading.</returns>
@@ -418,7 +418,7 @@ public static IReceivableSourceBlock<object[]> AsSourceBlockAsync(this IDataRead
418
418
/// <summary>
419
419
/// Starts reading an <see cref="IDataReader"/> in the background and returns a new <see cref="BufferBlock{T}"/> that receives each record as an array of values rented from an array pool as it is read.
420
420
/// </summary>
421
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
421
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
422
422
/// <param name="arrayPool">The array pool to rent each record's array from. The consumer of the records is responsible for returning each array to the pool.</param>
423
423
/// <param name="options">Options for the returned block, such as its bounded capacity, or <see langword="null"/> for the defaults.</param>
424
424
/// <param name="cancellationToken">A token that can cancel the reading. The block is then faulted with the resulting exception.</param>
@@ -442,7 +442,7 @@ public static IReceivableSourceBlock<object[]> AsSourceBlockAsync(this IDataRead
442
442
/// Starts reading an <see cref="IDataReader"/> in the background and returns a new <see cref="BufferBlock{T}"/> that receives each record after it has been transformed by <paramref name="transform"/> as it is read.
443
443
/// </summary>
444
444
/// <typeparam name="T">The type of the items delivered to the block: the return type of the transform function.</typeparam>
445
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
445
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
446
446
/// <param name="transform">The function that transforms each <see cref="IDataRecord"/> into the item delivered to the block.</param>
447
447
/// <param name="options">Options for the returned block, such as its bounded capacity, or <see langword="null"/> for the defaults.</param>
448
448
/// <param name="cancellationToken">A token that can cancel the reading. The block is then faulted with the resulting exception.</param>
@@ -466,7 +466,7 @@ public static IReceivableSourceBlock<T> AsSourceBlockAsync<T>(this IDataReader r
466
466
/// Starts reading an <see cref="IDataReader"/> in the background and returns a new <see cref="BufferBlock{T}"/> that receives each record mapped to a new instance of <typeparamref name="T"/> as it is read.
467
467
/// </summary>
468
468
/// <typeparam name="T">The type each record is mapped to.</typeparam>
469
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
469
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
470
470
/// <param name="options">Options for the returned block, such as its bounded capacity, or <see langword="null"/> for the defaults.</param>
471
471
/// <param name="cancellationToken">A token that can cancel the reading. The block is then faulted with the resulting exception.</param>
472
472
/// <returns>The block that receives the records. It is completed after the last record has been delivered, or faulted with the exception that ended the reading.</returns>
@@ -488,7 +488,7 @@ public static IReceivableSourceBlock<T> AsSourceBlockAsync<T>(this IDataReader r
488
488
/// Starts reading an <see cref="IDataReader"/> in the background and returns a new <see cref="BufferBlock{T}"/> that receives each record mapped to a new instance of <typeparamref name="T"/> by name, or through <paramref name="map"/> when given, as it is read.
489
489
/// </summary>
490
490
/// <typeparam name="T">The type each record is mapped to.</typeparam>
491
-
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes.</param>
491
+
/// <param name="reader">The data reader to iterate. The caller owns it: it is not closed or disposed here, and it must stay open until the operation completes. It is moved on to the next result set once the last row has been read, so that an error that follows the rows is raised.</param>
0 commit comments