SqlCeDataReader.GetBytes Método

Lee un flujo 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
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
Public Overrides Function GetBytes ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Uso
Dim instance As SqlCeDataReader
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Byte()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetBytes(ordinal, _
    dataIndex, buffer, bufferIndex, length)

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

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

[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetBytes : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int64 
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
override GetBytes : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:byte[] * 
        bufferIndex:int * 
        length:int -> int64 

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

Parámetros

• ordinal
  Tipo: System.Int32
  Ordinal de base cero de la columna.

• dataIndex
  Tipo: System.Int64
  Índice del campo desde el que se va a comenzar la operación de lectura.

• buffer
  Tipo: array<System.Byte[]
  Búfer en el que se lee el flujo de bytes.

• bufferIndex
  Tipo: System.Int32
  Índice de buffer para comenzar la operación de lectura.

• length
  Tipo: System.Int32
  Longitud máxima que se copiará en el búfer.

Valor devuelto

Tipo: System.Int64
Número real de bytes leídos.

Implementa

IDataRecord.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)

Excepciones

Comentarios

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 nulles una referencia NULL (Nothing en Visual Basic)., 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.

Vea también

Referencia

SqlCeDataReader Clase

Espacio de nombres System.Data.SqlServerCe