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

Odwołanie

Definicja

Przestrzeń nazw:: System.Data

Zestaw:: System.Data.Common.dll

Zestaw:: System.Data.dll

Zestaw:: netstandard.dll

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

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