SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Yöntem

Tanım

Ad Alanı:

Microsoft.SqlServer.Server

Bütünleştirilmiş Kod:

System.Data.dll

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

public:
 virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);

public virtual long GetChars(int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);

abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As Long

Parametreler

ordinal

Int32

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

fieldOffset

Int64

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

buffer

Char[]

Karakter kopyalanacak hedef arabellek.

bufferOffset

Int32

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

length

Int32

Arabelleğe kopyalanacak karakter sayısı.

Döndürülenler

Int64

Kopyalanan karakter sayısı.

Uygulamalar

GetChars(Int32, Int64, Char[], 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 bir karakter değeri 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 char dizisi ayırın ve her çağrıda parametreyi fieldOffset buna göre ayarlayarak art arda çağrısı GetChars yapın.