SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Metoda

Definice

Obor názvů:

Microsoft.SqlServer.Server

Sestavení:

System.Data.dll

Získá hodnotu pro sloupec určený pořadovým řádem jako pole Byte objektů.

public:
 virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);

public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);

abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64

Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As Long

Parametry

ordinal

Int32

Pořadová řada sloupce založená na nule.

fieldOffset

Int64

Posun do hodnoty pole, aby se začaly načítat bajty.

buffer

Byte[]

Cílová vyrovnávací paměť, do které se mají kopírovat bajty.

bufferOffset

Int32

Posun do vyrovnávací paměti, do které chcete začít kopírovat bajty.

length

Int32

Počet bajtů, které se mají zkopírovat do vyrovnávací paměti.

Návraty

Int64

Počet zkopírovaných bajtů.

Implementuje

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

Výjimky

IndexOutOfRangeException

Hodnota ordinal je menší než 0 nebo větší než počet sloupců (to znamená FieldCount).

SqlNullValueException

Sloupec zadaný parametrem ordinal má hodnotu null.

InvalidCastException

Došlo k neshodě typů.

Poznámky

Tato metoda umožňuje získat binární hodnotu buď v jednom volání, nebo v blocích. Získání hodnoty v blocích je užitečné pro velké hodnoty nebo hodnoty neznámé velikosti.

Pokud chcete získat hodnotu v několika blocích, přidělte pole bajtů o velikosti bloku dat a opakovaně volejte GetBytes a upravte fieldOffset parametr odpovídajícím způsobem v každém volání.