SqlDataReader.GetStream(Int32) Método

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Recupera binário, imagem, varbinary, UDT e tipos de dados Variant como um Stream.

public:
 override System::IO::Stream ^ GetStream(int i);

public override System.IO.Stream GetStream (int i);

override this.GetStream : int -> System.IO.Stream

Public Overrides Function GetStream (i As Integer) As Stream

Parâmetros

i

Int32

O ordinal da coluna baseado em zero.

Retornos

Stream

Um objeto de fluxo.

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:

• binary

• image

• varbinary

• udt

Comentários

ReadTimeoutusa como padrão o valor de ; mas você pode modificar ReadTimeout por meio de .CommandTimeoutGetStream

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

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

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

Os seguintes Stream membros não estão disponíveis para objetos retornados por GetStream:

• Beginwrite

• Endwrite

• Tamanho

• Posição

• Seek

• SetLength

• Gravar

• Writebyte

• WriteTimeout

Para obter mais informações, consulte Suporte ao Streaming do SqlClient.