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

Declaration

// C#
public Task<int> ReadAsync(char[] buffer, int offset, int count, CancellationToken cancellationToken)

Parameters

• buffer

  The character array buffer that is populated.

• offset

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

• count

  The amount of characters to be read.

• cancellationToken

  The input cancellation token which can be used by the application to cancel the task.

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.