SqlDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32) Metod

Definition

Namnområde:
System.Data.SqlClient
Sammansättning:
System.Data.dll

Läser en ström med byte från den angivna kolumnförskjutningen till bufferten en matris som börjar vid den angivna buffertförskjutningen.

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 -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long
Public Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long

Parametrar

i
Int32

Den nollbaserade kolumnordningen.

dataIndex
Int64

Indexet i fältet som läsåtgärden ska påbörjas från.

buffer
Byte[]

Bufferten som byteströmmen ska läsas i.

bufferIndex
Int32

Indexet i den buffer plats där skrivåtgärden ska starta.

length
Int32

Den maximala längden som ska kopieras till bufferten.

Returer

Int64

Det faktiska antalet lästa byte.

Implementeringar

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Kommentarer

GetBytes returnerar antalet tillgängliga byte i fältet. För det mesta är det den exakta längden på fältet. Talet som returneras kan dock vara mindre än fältets sanna längd om GetBytes det redan har använts för att hämta byte från fältet. Detta kan till exempel vara fallet om SqlDataReader läser en stor datastruktur i en buffert. Mer information finns i inställningen SequentialAccess för CommandBehavior.

Om du skickar en buffert som är nullreturnerar GetBytes längden på hela fältet i byte, inte den återstående storleken baserat på buffertförskjutningsparametern.

Inga konverteringar utförs. Därför måste de data som hämtas redan vara en bytematris.

Gäller för

Se även