SqlDataRecord.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.
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 -> int64Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As LongParametry
- 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.