OdbcDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Legge un flusso di byte dall'offset della colonna specificata nel buffer come una matrice, a partire dall'offset del buffer specificato.
public:
override long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public:
virtual long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public override long GetBytes (int i, long dataIndex, byte[]? buffer, int bufferIndex, int length);
public long GetBytes (int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
public override long GetBytes (int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
override this.GetBytes : int * int64 * byte[] * int * int -> int64
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Parametri
- i
- Int32
Ordinale di colonna in base zero.
- dataIndex
- Int64
Indice all'interno del campo dal quale iniziare l'operazione di lettura.
- buffer
- Byte[]
Buffer in cui leggere il flusso di byte.
- bufferIndex
- Int32
Indice all'interno del parametro buffer
dal quale iniziare l'operazione di scrittura.
- length
- Int32
Numero di byte da leggere.
Restituisce
Numero effettivo di byte letti.
Implementazioni
Commenti
GetBytes restituisce il numero di byte disponibili nel campo . La maggior parte del tempo è la lunghezza esatta del campo. Tuttavia, il numero restituito può essere minore della lunghezza reale del campo se GetBytes è già stato usato per ottenere byte dal campo. Questo può essere il caso, ad esempio, se sta OdbcDataReader leggendo una struttura di dati di grandi dimensioni in un buffer. Per altre informazioni, vedere l'impostazione SequentialAccess
per CommandBehavior.
Se si passa un buffer che è un valore Null, GetBytes restituisce la lunghezza del campo in byte.
Le conversioni vengono eseguite in base alle funzionalità sottostanti del driver ODBC. Se la conversione non è supportata, la chiamata al metodo avrà esito negativo.
Nota
Non verrà generata alcuna eccezione se il valore di bufferIndex
è esterno alla matrice. Non verranno letti dati e il metodo restituirà 0.