SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Yöntem

Tanım

Ad Alanı:

Microsoft.Data.SqlClient.Server

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Sıralı tarafından bir nesne dizisi olarak belirtilen sütunun Byte değerini alır.

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

Parametreler

ordinal

Int32

Sütunun sıfır tabanlı sıralı kısmı.

fieldOffset

Int64

Baytları almaya başlamak için alan değerine uzaklık.

buffer

Byte[]

Baytların kopyalandığı hedef arabellek.

bufferOffset

Int32

Bayt kopyalamaya başlanacak arabelleğe uzaklık.

length

Int32

Arabelleğe kopyalanacak bayt sayısı.

Döndürülenler

Int64

Kopyalanan bayt sayısı.

Uygulamalar

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

Özel durumlar

IndexOutOfRangeException

ordinal 0'dan küçük veya sütun sayısından büyük (başka bir ifadeyleFieldCount).

SqlNullValueException

tarafından ordinal belirtilen sütun null.

InvalidCastException

Tür uyuşmazlığı var.

Açıklamalar

Bu yöntem, tek bir çağrıda veya öbeklerde ikili değer almanıza olanak tanır. Öbeklerdeki değeri almak, büyük değerler veya bilinmeyen boyuttaki değerler için yararlıdır.

Değeri birkaç öbekte almak için, öbek boyutunda bir bayt dizisi ayırın ve her çağrıda parametresini uygun şekilde ayarlayarak fieldOffset art arda çağrısı GetBytes yapın.