SqlDataReader.GetTextReader(Int32) Метод

Определение

Извлекает типы данных Char, NChar, NText, NVarChar, text, varChar и Variant как TextReader.Retrieves Char, NChar, NText, NVarChar, text, varChar, and Variant data types as a TextReader.

public:
 override System::IO::TextReader ^ GetTextReader(int i);
public override System.IO.TextReader GetTextReader (int i);
override this.GetTextReader : int -> System.IO.TextReader
Public Overrides Function GetTextReader (i As Integer) As TextReader

Параметры

i
Int32

Получаемый столбец.The column to be retrieved.

Возвращаемое значение

Возвращаемый объект.The returned object.

Исключения

Соединение разъединяется или закрывается во время извлечения данных.The connection drops or is closed during the data retrieval.

Объект SqlDataReader закрыт во время извлечения данных.The SqlDataReader is closed during the data retrieval.

Не существует данных, готовых для чтения (например, первый объект Read() не был вызван или вернул значение false).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

Сделана попытка чтения ранее считанного столбца в последовательном режиме.Tried to read a previously-read column in sequential mode.

Выполнялась асинхронная операция.There was an asynchronous operation in progress. Относится ко всем методам Get* при работе в последовательном режиме, так как они могут вызываться при чтении потока.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

Попытка чтения столбца, который не существует.Trying to read a column that does not exist.

Возвращаемый тип не был одним из указанных ниже типов:The returned type was not one of the types below:

– char- char

– nchar- nchar

– ntext- ntext

– nvarchar- nvarchar

– text- text

– varchar- varchar

Комментарии

SqlException исключения, вызванные из TextReader, вызываются как исключения IOException; Проверьте внутреннее исключение для SqlException.SqlException exceptions raised from TextReader are thrown as IOException exceptions; check the inner exception for the SqlException.

Значения null будут возвращены как пустые (нулевые байты) TextReader.Null values will be returned as an empty (zero bytes) TextReader.

GetChars вызовет исключение InvalidOperationException при использовании объекта, возвращаемого GetTextReader, когда действует SequentialAccess.GetChars will raise an InvalidOperationException exception when used on an object returned by GetTextReader when SequentialAccess is in effect.

Если свойство соединения ContextConnection=true, GetTextReader поддерживает синхронное получение данных только для последовательного (SequentialAccess) и непоследовательного доступа (Default).When the connection property ContextConnection=true, GetTextReader only supports synchronous data retrieval for both sequential (SequentialAccess) and non-sequential (Default) access.

Дополнительные сведения см. в разделе Поддержка потоковой передачи SqlClient.For more information, see SqlClient Streaming Support.

Применяется к