Udostępnij przez

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

Definicja

Namespace:
System.Data
Zestawów:
netstandard.dll, System.Data.Common.dll
Montaż:
System.Data.Common.dll
Montaż:
System.Data.dll
Montaż:
netstandard.dll
Źródło:
IDataRecord.cs
Źródło:
IDataRecord.cs

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

Int64

Rzeczywista liczba odczytanych znaków.

Wyjątki

IndexOutOfRangeException

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.

Dotyczy