OdbcDataReader.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ślonej kolumny przesunięcia do buforu jako tablicy, zaczynając od przesunięcia określonego buforu.
public:
override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public:
virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public override long GetChars(int i, long dataIndex, char[]? buffer, int bufferIndex, int length);public long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);public override long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);override this.GetChars : int * int64 * char[] * int * int -> int64abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongPublic Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongParametry
- i
- Int32
Porządkowa kolumna oparta na zera.
- dataIndex
- Int64
Indeks w wierszu, w którym ma być uruchamiana operacja odczytu.
- buffer
- Char[]
Bufor, do którego mają być kopiować dane.
- bufferIndex
- Int32
Indeks w obszarze, w buffer którym ma być uruchamiana operacja zapisu.
- length
- Int32
Liczba znaków do odczytania.
Zwraca
Rzeczywista liczba odczytanych znaków.
Implementuje
Uwagi
GetChars Zwraca liczbę dostępnych znaków w polu. W większości przypadków jest to dokładna długość pola. Jednak zwracana liczba może być mniejsza niż prawdziwa długość pola, jeśli GetChars została już użyta do uzyskania znaków z pola. Może to być na przykład przypadek, jeśli OdbcDataReader obiekt odczytuje dużą strukturę danych do buforu. Aby uzyskać więcej informacji, zobacz SequentialAccess ustawienie dla CommandBehaviorelementu .
W przypadku przekazania buforu, który jest wartością null, GetChars zwraca długość pola w znakach.
Konwersje są wykonywane na podstawie podstawowych możliwości sterownika ODBC. Jeśli konwersja nie jest obsługiwana, wywołanie metody zakończy się niepowodzeniem.
Note
Nie zostanie zgłoszony wyjątek, jeśli wartość bufferIndex elementu znajduje się poza tablicą. Żadne dane nie zostaną odczytane, a metoda zwróci wartość 0.
