IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Odczytuje strumień znaków z określonego przesunięcia kolumny do buforu jako tablicy, począwszy od danego przesunięcia buforu.
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);
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
Parametry
- i
- Int32
Liczba porządkowa kolumn opartych na zerach.
- fieldoffset
- Int64
Indeks w wierszu, z którego ma rozpocząć operację odczytu.
- buffer
- Char[]
Bufor, do którego ma być odczytywany strumień bajtów.
- bufferoffset
- Int32
Indeks umożliwiający buffer
rozpoczęcie operacji odczytu.
- length
- Int32
Liczba bajtów do odczytania.
Zwraca
Rzeczywista liczba odczytanych znaków.
Wyjątki
Przekazany indeks wykraczał poza zakres od 0 do FieldCount.
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ż dokładna długość pola, jeśli GetChars
została już użyta do uzyskania znaków z pola.
W przypadku przekazania buforu, który jest null
, GetChars
zwraca długość pola w znakach.
Nie są wykonywane żadne konwersje; w związku z tym pobrane dane muszą już być tablicą znaków.