SqlCeResultSet.GetBytes Method

Articolo
01/14/2011

Copia una lunghezza di byte nel buffer, a partire dalla posizione specificata nel campo specificato.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
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

Parametri

ordinal
Posizione ordinale della colonna da cui recuperare i dati.

dataIndex
Offset (in byte) all'interno del campo da cui iniziare a copiare i dati.

buffer
Buffer in cui copiare i dati.

bufferIndex
Offset all'interno del buffer da cui iniziare la copia.

length
Numero massimo di byte da copiare.

Valore restituito

Numero effettivo di byte copiati nel buffer.

Osservazioni

Questa funzione restituisce il numero effettivo di byte copiati, che può essere inferiore alla lunghezza richiesta se viene raggiunta la fine del campo.

Se si passa un buffer con valore null, il metodo GetBytes restituisce la lunghezza del campo espressa in byte.

Se il comando viene eseguito con l'impostazione SequentialAccess, nelle chiamate al metodo GetBytes è necessario specificare letture con incrementi sequenziali. In caso contrario, viene generata un'eccezione.

Il metodo GetBytes può essere chiamato solo per colonne il cui tipo è binary o varbinary o che sono state create con oggetti di cui è possibile eseguire il cast a una matrice di byte.

Se nella posizione ordinale specificata non è presente alcun campo, viene generata un'eccezione.

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeResultSet Class
SqlCeResultSet Members
System.Data.SqlServerCe Namespace

Condividi tramite