SqlCeDataReader.GetBytes Method

Legge un flusso di byte dalla colonna specificata nel buffer come una matrice a partire dall'offset del buffer determinato.

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
  Ordinale della colonna in base zero.

• dataIndex
  Indice all'interno del campo dal quale iniziare l'operazione di lettura.

• buffer
  Buffer in cui leggere il flusso di byte.

• bufferIndex
  Indice per buffer da cui iniziare l'operazione di lettura.

• length
  Lunghezza massima per la copia nel buffer.

Valore restituito

Numero effettivo di byte letti.

Eccezioni

Osservazioni

Il metodo GetBytes restituisce il numero di byte disponibili nel campo. Nella maggior parte dei casi si tratta della lunghezza esatta del campo. Se il metodo GetBytes è già stato utilizzato per ottenere i byte dal campo, il numero restituito potrebbe tuttavia essere minore della lunghezza effettiva del campo. Questa situazione può verificarsi, ad esempio, quando un'ampia struttura di dati in un buffer viene letta mediante la classe SqlCeDataReader. Per ulteriori informazioni, vedere l'impostazione SequentialAccess relativa all'enumerazione CommandBehavior.

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

Non viene effettuata alcuna conversione, quindi i dati recuperati devono essere già una matrice di byte.

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

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace