Udostępnij za pośrednictwem


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

Definicja

Pobiera wartość dla kolumny określonej przez porządkową jako tablicę Char obiektów.

public:
 virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);
public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As Long

Parametry

ordinal
Int32

Liczba porządkowa oparta na zerach kolumny.

fieldOffset
Int64

Przesunięcie wartości pola w celu rozpoczęcia pobierania znaków.

buffer
Char[]

Bufor docelowy do kopiowania znaków.

bufferOffset
Int32

Przesunięcie do buforu w celu rozpoczęcia kopiowania znaków do.

length
Int32

Liczba znaków do skopiowania do buforu.

Zwraca

Liczba skopiowanych znaków.

Implementuje

Wyjątki

Wartość ordinal jest mniejsza niż 0 lub większa niż liczba kolumn (czyli FieldCount).

Kolumna określona przez ordinal ma wartość null.

Wystąpiła niezgodność typów.

Uwagi

Ta metoda umożliwia uzyskanie wartości znaku w jednym wywołaniu lub we fragmentach. Pobieranie wartości we fragmentach jest przydatne w przypadku dużych wartości lub wartości o nieznanym rozmiarze.

Aby uzyskać wartość w kilku fragmentach, należy przydziel tablicę znaków rozmiaru fragmentu i GetChars wywołaj wielokrotnie dostosowywanie parametru fieldOffset w każdym wywołaniu.

Dotyczy