VistaDB 6
VistaDB.Provider Namespace / VistaDBDataReader Class / NextResultAsync Method / NextResultAsync(CancellationToken) Method
The cancellation instruction.


In This Topic
    NextResultAsync(CancellationToken) Method
    In This Topic
    This is the asynchronous version of System.Data.Common.DbDataReader.NextResult. Providers should override with an appropriate implementation. The cancellationToken may optionally be ignored. The default implementation invokes the synchronous System.Data.Common.DbDataReader.NextResult method and returns a completed task, blocking the calling thread. The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Exceptions thrown by System.Data.Common.DbDataReader.NextResult will be communicated via the returned Task Exception property. Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. Advances the reader to the next result when reading the results of a batch of statements.
    Syntax
    'Declaration
     
    
    <System.Runtime.CompilerServices.AsyncStateMachineAttribute(VistaDB.Provider.VistaDBDataReader/d__68)> 
    Public Overloads Overrides NotOverridable Function NextResultAsync( _ 
       ByVal cancellationToken As System.Threading.CancellationToken _ 
    ) As System.Threading.Tasks.Task(Of Boolean)
    'Usage
     
    
    Dim instance As VistaDBDataReader
    Dim cancellationToken As System.Threading.CancellationToken
    Dim value As System.Threading.Tasks.Task(Of Boolean)
     
    value = instance.NextResultAsync(cancellationToken)
    [System.Runtime.CompilerServices.AsyncStateMachine(VistaDB.Provider.VistaDBDataReader/d__68)] 
    public override System.Threading.Tasks.Task<bool> NextResultAsync( 
       System.Threading.CancellationToken cancellationToken 
    )

    Parameters

    cancellationToken
    The cancellation instruction.

    Return Value

    A task representing the asynchronous operation.This method allows you to process multiple result sets returned when a batch is submitted to the data provider.
    Exceptions
    ExceptionDescription
    An error occurred while executing the command text.
    Example
    See VistaDBDataReader Class for an example of how to use this method.
    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also