dotConnect for PostgreSQL Documentation
Devart.Data.PostgreSql Namespace / PgSqlCommand Class / EndExecuteReader Method
The System.IAsyncResult returned from BeginExecuteReader.
Example

In This Topic
    EndExecuteReader Method (PgSqlCommand)
    In This Topic
    Ends an asynchronous invocation of the ExecuteReader method.
    Ends an asynchronous invocation of the ExecuteReader method.
    Syntax
    'Declaration
     
    Public Shadows Function EndExecuteReader( _
       ByVal result As IAsyncResult _
    ) As PgSqlDataReader
    public new PgSqlDataReader EndExecuteReader( 
       IAsyncResult result
    )

    Parameters

    result
    The System.IAsyncResult returned from BeginExecuteReader.

    Return Value

    A PgSqlDataReader object.
    Remarks
    The function ends an asynchronous execution of a query that is started with BeginExecuteReader. A pair of asynchronous functions (BeginExecuteReader and EndExecuteReader) can be used instead of the synchronous function ExecuteReader to gain more performance and flexibility in your application.

    Refer to "Asynchronous Query Execution" article for detailed information.

    Example
    In the example below an easiest way of executing an asynchronous operation is shown. First, all components are set up and a connection is opened. Second, a data retrieval operation is started. The operation state (done or in progress) is checked and a report is written to the console. At last query results are sent to PgSqlDataReader and rendered to the console.
    Public void Async_Exec(PgSqlConnection pgConnection)
    {
      PgSqlCommand pgCommand = new PgSqlCommand("SELECT * FROM Test.Dept",pgConnection);
      Console.WriteLine("Starting asynchronous retrieval of data...");
      pgConnection.Open();
      IAsyncResult cres = pgCommand.BeginExecuteReader(null,null,CommandBehavior.Default);
      if (cres.IsCompleted)
        Console.WriteLine("Completed.");
      else
        Console.WriteLine("Have to wait for operation to complete...");
      PgSqlDataReader pgReader = pgCommand.EndExecuteReader(cres);
      try
      {
        while (pgReader.Read())
        {
          Console.WriteLine(pgReader.GetInt32(0) + " " + pgReader.GetString(1) + " " + pgReader.GetString(2));
        }
      }
      finally
      {
        pgReader.Close();
        pgConnection.Close();
      }
    }
    Public Sub Async_Exec(ByVal pgConnection As PgSqlConnection)
      Dim pgCommand As New PgSqlCommand("SELECT * FROM Test.Dept", pgConnection)
      Console.WriteLine("Starting asynchronous retrieval of data...")
      pgConnection.Open()
      Dim cres As IAsyncResult = pgCommand.BeginExecuteReader(Nothing, Nothing, CommandBehavior.Default)
      If cres.IsCompleted Then
        Console.WriteLine("Completed.")
      Else
        Console.WriteLine("Have to wait for operation to complete...")
      End If
      Dim pgReader As PgSqlDataReader = pgCommand.EndExecuteReader(cres)
      Try
        While pgReader.Read()
          Console.WriteLine(String.Concat(pgReader.GetInt32(0), " ", pgReader.GetString(1), " ", pgReader.GetString(2)))
        End While
      Finally
        pgReader.Close()
        pgConnection.Close()
      End Try
    End Sub
    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