ReadAsync(byte[], int, int)

The ReadAsync method returns a Task-based asynchronous version of OracleBlob.Read(), which reads a specified number of bytes from the ODP.NET LOB instance and populates the buffer.

Declaration

// C#
public Task<int> ReadAsync(byte[] buffer, int offset, int count);

Parameters

  • buffer

    The byte array buffer to be populated.

  • offset

    The starting offset (in bytes) at which the buffer is populated.

  • count

    The number of bytes to read.

Return Value

Task<Int> object representing the asynchronous operation immediately without blocking the calling thread for the whole duration of the query execution.

Exceptions

  • ObjectDisposedException - The object is already disposed.

  • InvalidOperationException - The OracleConnection is not open or has been closed during the lifetime of the object
  • ArgumentOutOfRangeException - This exception is thrown if any of the following conditions exist:

    • The offset or the count parameter is less than 0.

    • The offset is greater than or equal to the buffer.Length.

    • The offset and the count together are greater than the buffer.Length.

Remark

This will call into the ReadAsync implementation with argument cancellationToken passed as CancellationToken.None.