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

Definisi

Ruang nama:

Microsoft.SqlServer.Server

Rakitan:

System.Data.dll

Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai array Byte objek.

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

Parameter

ordinal

Int32

Ordinal kolom berbasis nol.

fieldOffset

Int64

Offset ke dalam nilai bidang untuk mulai mengambil byte.

buffer

Byte[]

Buffer target yang akan disalin byte.

bufferOffset

Int32

Offset ke dalam buffer untuk mulai menyalin byte.

length

Int32

Jumlah byte yang akan disalin ke buffer.

Mengembalikan

Int64

Jumlah byte yang disalin.

Penerapan

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

Pengecualian

IndexOutOfRangeException

ordinal kurang dari 0 atau lebih besar dari jumlah kolom (yaitu, FieldCount).

SqlNullValueException

Kolom yang ditentukan oleh ordinal null.

InvalidCastException

Ada jenis ketidakcocokan.

Keterangan

Metode ini memungkinkan Anda untuk mendapatkan nilai biner baik dalam satu panggilan atau dalam gugus. Mendapatkan nilai dalam gugus berguna untuk nilai besar atau nilai dengan ukuran yang tidak diketahui.

Untuk mendapatkan nilai dalam beberapa gugus, alokasikan array byte dari ukuran gugus dan panggil GetBytes berulang kali, sesuaikan fieldOffset parameter yang sesuai dalam setiap panggilan.