Bewerken

Share via


DbDataReader.NextResultAsync Method

Definition

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().

See also

Applies to