DbDataReader.GetStream(Int32) Method

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbDataReader.cs

Gets a stream to retrieve data from the specified column.

public:
 virtual System::IO::Stream ^ GetStream(int ordinal);

public virtual System.IO.Stream GetStream (int ordinal);

abstract member GetStream : int -> System.IO.Stream
override this.GetStream : int -> System.IO.Stream

Public Overridable Function GetStream (ordinal As Integer) As Stream

Parameters

ordinal

Int32

The zero-based column ordinal.

Returns

Stream

A stream.

Exceptions

InvalidOperationException

The connection was dropped or closed during the data retrieval.

-or-

The data reader is closed during the data retrieval.

-or-

There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

-or-

The data reader tried to read a previously-read column in sequential mode.

-or-

There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

IndexOutOfRangeException

The column index is out of range.

InvalidCastException

The specified column isn't a binary type that supports reading with a Stream.

Remarks

GetStream only supports the retrieval of values that can be converted to byte arrays.