SqlDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Metoda

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.dll

Odczytuje strumień znaków z określonej kolumny przesunięcia do buforu jako tablicy rozpoczynającej się od danego przesunięcia buforu.

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

Parametry

i
Int32

Porządkowa kolumna oparta na zera.

dataIndex
Int64

Indeks w polu, z którego ma rozpocząć operację odczytu.

buffer
Char[]

Bufor, do którego ma być odczytywany strumień bajtów.

bufferIndex
Int32

Indeks w obszarze, w buffer którym ma być uruchamiana operacja zapisu.

length
Int32

Maksymalna długość kopiowania do buforu.

Zwraca

Int64

Rzeczywista liczba odczytanych znaków.

Implementuje

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

Uwagi

GetChars Zwraca liczbę dostępnych znaków w polu. Często jest to dokładna długość pola. Jednak zwracana liczba może być mniejsza niż prawdziwa długość pola, jeśli GetChars została już użyta do uzyskania znaków z pola. Może to być na przykład przypadek, jeśli SqlDataReader obiekt odczytuje dużą strukturę danych do buforu. Aby uzyskać więcej informacji, zobacz SequentialAccess ustawienie dla CommandBehaviorelementu .

Rzeczywista liczba odczytanych znaków może być mniejsza niż żądana długość, jeśli osiągnięto koniec pola. Jeśli przekażesz bufor, który ma nullwartość , GetChars zwraca długość całego pola w znakach, a nie pozostały rozmiar na podstawie parametru przesunięcia buforu.

Nie są wykonywane żadne konwersje; Dlatego. pobrane dane muszą być już tablicą znaków.

Note

Metoda GetChars zwraca wartość 0, gdy dataIndex jest ujemna.

Dotyczy

Zobacz też