DbDataReader.GetTextReader(Int32) Method

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbDataReader.cs

Gets a text reader to retrieve data from the column.

public:
 virtual System::IO::TextReader ^ GetTextReader(int ordinal);

public virtual System.IO.TextReader GetTextReader (int ordinal);

abstract member GetTextReader : int -> System.IO.TextReader
override this.GetTextReader : int -> System.IO.TextReader

Public Overridable Function GetTextReader (ordinal As Integer) As TextReader

Parameters

ordinal

Int32

The zero-based column ordinal.

Returns

TextReader

A text reader.

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 text type that supports reading with a TextReader.

Remarks

GetTextReader only supports the retrieval of values that can be converted to character arrays (strings).