DbDataReader.GetTextReader(Int32) Method

Definition

Namespace:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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).

Applies to