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

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Belirtilen sütun uzaklığından arabelleğe verilen arabellek uzaklığından başlayarak bir dizi olarak bir karakter akışı okur.

public:
 long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);

public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);

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

Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

Parametreler

i

Int32

Sıfır tabanlı sütun sıralı.

fieldoffset

Int64

Okuma işleminin başlatıldığı satırdaki dizin.

buffer

Char[]

Bayt akışının okunduğu arabellek.

bufferoffset

Int32

Okuma işlemini başlatmak için buffer dizini.

length

Int32

Okunacak bayt sayısı.

Döndürülenler

Int64

Okunan gerçek karakter sayısı.

Özel durumlar

IndexOutOfRangeException

Geçirilen dizin, ile arasında 0 FieldCountaralığının dışındaydı.

Açıklamalar

GetChars alandaki kullanılabilir karakterlerin sayısını döndürür. Bu genellikle alanın tam uzunluğudur. Ancak, alandan karakter almak için zaten kullanılmışsa GetChars , döndürülen sayı alanın tam uzunluğundan küçük olabilir.

olan nullGetChars bir arabellek geçirirseniz, alanın uzunluğunu karakter cinsinden döndürür.

Dönüştürme yapılmaz; bu nedenle alınan verilerin zaten bir karakter dizisi olması gerekir.