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

Başvuru

Tanım

Ad Alanı:: System.Data.SqlClient

Bütünleştirilmiş Kod:: System.Data.SqlClient.dll

Bütünleştirilmiş Kod:: System.Data.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 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 SqlDataReader bu durum söz konusu olabilir. Daha fazla bilgi için CommandBehaviorayarına SequentialAccess bakın.

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

Hiçbir dönüştürme gerçekleştirilmiyor; Bu nedenle. alınan veriler zaten bir karakter dizisi olmalıdır.

Not

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

Şunlara uygulanır

Aracılığıyla paylaş