Share via


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

Tanım

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

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int i, long dataIndex, char[]? buffer, int bufferIndex, int length);
public long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parametreler

i
Int32

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

dataIndex
Int64

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

buffer
Char[]

Verilerin kopyalandığı arabellek.

bufferIndex
Int32

yazma işleminin buffer başlatıldığı dizin.

length
Int32

Okunacak karakter sayısı.

Döndürülenler

Okunan gerçek karakter sayısı.

Uygulamalar

Açıklamalar

GetChars alandaki kullanılabilir karakterlerin sayısını döndürür. Çoğu zaman bu, alanın tam uzunluğudur. Ancak, alandan karakterleri almak için zaten kullanılmışsa GetChars , döndürülen sayı alanın gerçek uzunluğundan küçük olabilir. Örneğin, büyük bir veri yapısını arabelleğe okuyorsa OdbcDataReader bu durum söz konusu olabilir. Daha fazla bilgi için CommandBehaviorayarına SequentialAccess bakın.

Null değer olan bir arabelleğe geçirirseniz, GetChars alanın uzunluğunu karakter cinsinden döndürür.

Dönüştürmeler ODBC sürücüsünün temel özelliklerine göre gerçekleştirilir. Dönüştürme desteklenmiyorsa yöntem çağrısı başarısız olur.

Not

değeri bufferIndex dizinin dışındaysa özel durum oluşturulmayacak. Hiçbir veri okunmayacak ve yöntem 0 döndürecektir.

Şunlara uygulanır

Ayrıca bkz.