Compartir a través de

SqlCeDataReader.GetBytes Method

  • Artículo

Lee una secuencia de bytes del desplazamiento de la columna especificada en el búfer como matriz, comenzando en el desplazamiento de búfer dado.

Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)

Sintaxis

'Declaración
Public Overrides Function GetBytes ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long

public override long GetBytes (
    int ordinal,
    long dataIndex,
    byte[] buffer,
    int bufferIndex,
    int length
)

public:
virtual long long GetBytes (
    int ordinal, 
    long long dataIndex, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) override

public long GetBytes (
    int ordinal, 
    long dataIndex, 
    byte[] buffer, 
    int bufferIndex, 
    int length
)

public override function GetBytes (
    ordinal : int, 
    dataIndex : long, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : long

Parámetros

  • ordinal
    Ordinal de base cero de la columna.
  • dataIndex
    Índice del campo desde el que se va a comenzar la operación de lectura.
  • buffer
    Búfer en el que se lee la secuencia de bytes.
  • bufferIndex
    Índice de buffer para comenzar la operación de lectura.
  • length
    Longitud máxima que se copiará en el búfer.

Valor devuelto

Número real de bytes leídos.

Excepciones

Tipo de excepción Condición
InvalidOperationException

La operación no es válida. SqlCeDataReader puede colocarse detrás de la última fila del conjunto de resultados.

Notas

GetBytes devuelve el número de bytes disponibles en el campo. En la mayoría de los casos, se trata de la longitud exacta del campo. Sin embargo, el valor devuelto puede ser menor que la longitud del campo si GetBytes ya se ha utilizado para obtener bytes del campo. Esto puede suceder, por ejemplo, cuando el objeto SqlCeDataReader está leyendo una gran estructura de datos en un búfer. Para obtener más información, vea el valor de SequentialAccess para CommandBehavior.

Si se pasa un búfer que es null, GetBytes devuelve la longitud del campo en bytes.

No se realizan conversiones, por lo que los datos recuperados deben presentarse en forma de matriz de bytes.

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace