DbDataReader.NextResultAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Asynchronously advances the reader to the next result when reading the results of a batch of statements.
Overloads
| NextResultAsync() |
Asynchronously advances the reader to the next result when reading the results of a batch of statements. |
| NextResultAsync(CancellationToken) |
Asynchronously advances the reader to the next result when reading the results of a batch of statements. |
Remarks
For more information about asynchronous programming, see Asynchronous Programming.
NextResultAsync()
- Source:
- DbDataReader.cs
- Source:
- DbDataReader.cs
- Source:
- DbDataReader.cs
Asynchronously advances the reader to the next result when reading the results of a batch of statements.
public:
System::Threading::Tasks::Task<bool> ^ NextResultAsync();public System.Threading.Tasks.Task<bool> NextResultAsync ();member this.NextResultAsync : unit -> System.Threading.Tasks.Task<bool>Public Function NextResultAsync () As Task(Of Boolean)Returns
A task whose Result property is true if there are more result sets or false if there aren't.
Exceptions
An error occurred while executing the command text.
Remarks
The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.
Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.
Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as ArgumentException, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by NextResult().
See also
Applies to
NextResultAsync(CancellationToken)
- Source:
- DbDataReader.cs
- Source:
- DbDataReader.cs
- Source:
- DbDataReader.cs
Asynchronously advances the reader to the next result when reading the results of a batch of statements.
public:
virtual System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<bool> NextResultAsync (System.Threading.CancellationToken cancellationToken);abstract member NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- cancellationToken
- CancellationToken
The cancellation instruction.
Returns
A Task<TResult> whose Result property is true if there are more result sets or false if there aren't.
Exceptions
An error occurred while executing the command text.
The cancellation token was canceled. This exception is stored into the returned task.
Remarks
The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread. The default implementation also returns a cancelled task if passed an already cancelled cancellation token.
Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.
This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementations may ignore this request.
Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as ArgumentException, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by NextResult().
