SqlDataReader.GetStream(Int32) Método

Definición

Espacio de nombres:
System.Data.SqlClient
Ensamblado:
System.Data.dll

Recupera tipos de datos binarios, image, varbinary, UDT y variant como 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

Ordinal de columna de base cero.

Devoluciones

Stream

Objeto stream.

Excepciones

InvalidOperationException

La conexión quita o se cierra durante la recuperación de datos.

SqlDataReader se cierra durante la recuperación de datos.

No hay datos listos para leerse (por ejemplo, no se ha llamado a la primera Read() o se ha devuelto false).

Intentó leer una columna de lectura anterior en modo secuencial.

Hubo una operación asincrónica en curso. Esto se aplica a todos los métodos Get* al ejecutarse en modo secuencial, ya que se podría llamar al leer una secuencia.

IndexOutOfRangeException

Intentar leer una columna que no existe.

InvalidCastException

El tipo devuelto no era uno de los tipos siguientes:

  • binario
  • image
  • varbinary
  • udt

Comentarios

ReadTimeoutel valor predeterminado es ; pero se puede modificar ReadTimeout a través GetStreamde CommandTimeout.

Los valores NULL se devolverán como un valor vacío (cero bytes). Stream

GetBytes generará una InvalidOperationException excepción cuando se use en un objeto devuelto por GetStream cuando SequentialAccess está en vigor.

SqlException Las excepciones generadas a partir de Stream se inician como IOException excepciones; compruebe la excepción interna de SqlException.

Los siguientes Stream miembros no están disponibles para los objetos devueltos por GetStream:

  • ComenzarEscribir

  • Fin de Escritura

  • Largura

  • Position

  • Buscar

  • EstablecerLongitud

  • Escribir

  • WriteByte

  • WriteTimeout

Cuando la propiedad ContextConnection=truede conexión , GetStream solo admite la recuperación de datos sincrónicos para el acceso secuencial (SequentialAccess) y no secuencial (Default).

Para obtener más información, consulte Compatibilidad con streaming de SqlClient.

Se aplica a