SqlDataReader.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 een matrix die begint bij de opgegeven buffer offset.
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, cli::array <System::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);abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64override this.GetBytes : int * int64 * byte[] * int * int -> int64Public Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As LongPublic Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As LongParameters
- i
- Int32
De op nul gebaseerde kolomordinaal.
- dataIndex
- Int64
De index in het veld waaruit 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
De maximale lengte die moet worden gekopieerd naar de buffer.
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 SqlDataReader grote gegevensstructuur in een buffer wordt gelezen. Zie voor meer informatie de SequentialAccess instelling voor CommandBehavior.
Als u een buffer doorgeeft, nullGetBytes retourneert u de lengte van het hele veld in bytes, niet de resterende grootte op basis van de bufferverschilparameter.
Er worden geen conversies uitgevoerd; Daarom moeten de opgehaalde gegevens al een bytematrix zijn.