SqlDataReader.GetTextReader(Int32) Método

  • Referência

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacote:
System.Data.SqlClient v4.8.6

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

SqlExceptionexceções geradas de TextReader são geradas como IOException exceções; marcar a exceção interna para o 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.

Quando a propriedade ContextConnection=truede conexão , GetTextReader só dá suporte à recuperação de dados síncrona para acesso sequencial (SequentialAccess) e não sequencial (Default).

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

Aplica-se a