OdbcDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Leest een stroom van bytes van de opgegeven kolom offset in de buffer als een matrix, te beginnen bij de specifieke buffer offset.
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
Parameters
- i
- Int32
De op nul gebaseerde kolomordinaal.
- dataIndex
- Int64
De index in het veld waar de leesbewerking moet worden gestart.
- buffer
- Byte[]
De buffer waarin de stroom van bytes moet worden gelezen.
- bufferIndex
- Int32
De index binnen de buffer plaats waar de schrijfbewerking moet worden gestart.
- length
- Int32
Het aantal te lezen bytes.
Retouren
Het werkelijke aantal bytes dat is gelezen.
Implementeringen
Opmerkingen
GetBytes retourneert het aantal beschikbare bytes in het veld. Meestal is dit de exacte lengte van het veld. Het geretourneerde getal kan echter kleiner zijn dan de werkelijke lengte van het veld als GetBytes het al is gebruikt om bytes van het veld te verkrijgen. Dit kan bijvoorbeeld het geval zijn als een OdbcDataReader grote gegevensstructuur in een buffer wordt gelezen. Zie voor meer informatie de SequentialAccess instelling voor CommandBehavior.
Als u een buffer doorgeeft die een null-waarde is, GetBytes wordt de lengte van het veld in bytes geretourneerd.
Conversies worden uitgevoerd op basis van de onderliggende mogelijkheden van het ODBC-stuurprogramma. Als de conversie niet wordt ondersteund, mislukt de methode-aanroep.
Note
Er wordt geen uitzondering gegenereerd als de waarde bufferIndex buiten de matrix valt. Er worden geen gegevens gelezen en de methode retourneert 0.