Metodo SqlCeDataReader.GetBytes
Legge un flusso di byte dall'offset di colonna indicato nel buffer come matrice a partire dall'offset del buffer specificato.
Spazio dei nomi System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Sintassi
'Dichiarazione
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
Public Overrides Function GetBytes ( _
ordinal As Integer, _
dataIndex As Long, _
buffer As Byte(), _
bufferIndex As Integer, _
length As Integer _
) As Long
'Utilizzo
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
Parametri
- ordinal
Tipo: System.Int32
Ordinale di colonna in base zero.
- dataIndex
Tipo: System.Int64
Indice all'interno del campo dal quale iniziare l'operazione di lettura.
- buffer
Tipo: array<System.Byte[]
Buffer in cui leggere il flusso di byte.
- bufferIndex
Tipo: System.Int32
Indice per l'oggetto buffer da cui iniziare l'operazione di lettura.
- length
Tipo: System.Int32
Lunghezza massima per la copia nel buffer.
Valore restituito
Tipo: System.Int64
Numero effettivo di byte letti.
Implementa
IDataRecord.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)
Eccezioni
| Eccezione | Condizione |
|---|---|
| InvalidOperationException | L'operazione non è valida. L'oggetto SqlCeDataReader può essere posizionato dopo l'ultima riga nel set di risultati. |
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 è nullriferimento Null (Nothing in Visual Basic)., 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.