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

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.SqlClient.dll
Bütünleştirilmiş Kod:
System.Data.dll
Kaynak:
System.Data.SqlClient.notsupported.cs

Belirtilen sütun uzaklığından arabelleğe verilen arabellek uzaklığından başlayan bir 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);
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ığı alan içindeki dizin.

buffer
Char[]

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

bufferIndex
Int32

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

length
Int32

Arabelleğe kopyalanacak maksimum uzunluk.

Döndürülenler

Int64

Okunan gerçek karakter sayısı.

Uygulamalar

GetChars(Int32, Int64, Char[], Int32, Int32)

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 gerçek uzunluğundan küçük olabilir. Örneğin, büyük bir veri yapısını bir arabelleğe okuyorsa SqlDataReader bu durum söz konusu olabilir. Daha fazla bilgi için SequentialAccessayarına CommandBehavior bakın.

Alanın sonuna ulaşılırsa, okunan gerçek karakter sayısı istenen uzunluktan küçük olabilir. olan nullGetChars bir arabellek geçirirseniz, arabellek uzaklığı parametresine göre kalan boyutu değil, tüm alanın uzunluğunu karakterler halinde döndürür.

Dönüştürme yapılmaz; Bu nedenle. alınan veriler zaten bir karakter dizisi olmalıdır.

Note

GetChars yöntemi negatif olduğunda dataIndex 0 döndürür.

Şunlara uygulanır

Ayrıca bkz.