SqlDataReader.GetStream(Int32) Método

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.SqlClient.dll

Paquete:

System.Data.SqlClient v4.8.6

Recupera los tipos de datos binary, 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

Índice de la columna de base cero.

Devoluciones

Stream

Objeto de secuencia.

Excepciones

InvalidOperationException

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

SqlDataReader se cierra durante la recuperación de datos.

No hay ningún dato listo para leer (por ejemplo, no se ha llamado al primer Read() o ha devuelto false).

Se intentó leer una columna leída previamente en modo secuencial.

Había una operación asincrónica en curso. Esto se aplica a todos los métodos Get* cuando se ejecutan en modo secuencial, ya que se les podía llamar mientras se leía una secuencia.

IndexOutOfRangeException

Se intentó leer una columna que no existe.

InvalidCastException

El tipo devuelto no es uno de los tipos siguientes:

• binary

• imagen

• varbinary

• udt

Comentarios

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

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

GetBytes generará una InvalidOperationException excepción cuando se usa 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 miembros siguientes Stream no están disponibles para los objetos devueltos por GetStream:

• BeginWrite

• EndWrite

• Length

• Posición

• Seek

• SetLength

• Escritura

• 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 más información, consulte Compatibilidad con streaming de SqlClient.