SqlDataReader.GetTextReader(Int32) Método

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Recupera os tipos de dados Char, NChar, NText, NVarChar, texto, varChar e Variant como um 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

Parâmetros

i

Int32

A coluna a ser recuperada.

Retornos

TextReader

O objeto retornado.

Exceções

InvalidOperationException

A conexão cai ou é fechada durante a recuperação de dados.

O SqlDataReader é fechado durante a recuperação de dados.

Não há dados prontos para serem lidos (por exemplo, o primeiro Read() não foi chamado ou retornou false).

Tentativa de ler uma coluna lida anteriormente no modo sequencial.

Havia uma operação assíncrona em andamento. Isso se aplica a todos os métodos Get* executados no modo sequencial, pois eles podem ser chamados durante a leitura de um fluxo.

IndexOutOfRangeException

Tentativa de ler uma coluna não existente.

InvalidCastException

O tipo retornado não foi um dos tipos a seguir:

• char

• NCHAR

• ntext

• NVARCHAR

• text

• varchar

Comentários

SqlException exceções geradas de TextReader são geradas como IOException exceções; verifique a exceção interna do SqlException.

Os valores nulos serão retornados como um vazio (zero bytes). TextReader

GetChars gerará uma exceção InvalidOperationException quando usado em um objeto retornado por GetTextReader quando SequentialAccess estiver em vigor.

Para obter mais informações, consulte Suporte de streaming do SqlClient.