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

Tanım

Ad Alanı:

Microsoft.SqlServer.Server

Bütünleştirilmiş Kod:

System.Data.dll

Sıra 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ı.

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 sütun sayısından (yani FieldCount) 0'dan küçük veya daha büyüktür.

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 bir değer elde etmenizi sağlar. Değeri öbekler halinde almak, büyük değerler veya bilinmeyen boyuttaki değerler için yararlıdır.

Değeri birkaç öbek halinde almak için, öbek boyutunda bir bayt dizisi ayırın ve her çağrıda parametresini uygun şekilde ayarlayarak fieldOffset tekrar tekrar çağırınGetBytes.