OleDbDataReader.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ślonego przesunięcia kolumny do buforu jako tablicę rozpoczynającą się od danego przesunięcia buforu.
public:
override long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
virtual long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[]? buffer, int bufferIndex, int length);
public long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Parametry
- ordinal
- Int32
Liczba porządkowa kolumn opartych na zerach.
- dataIndex
- Int64
Indeks w wierszu, z którego ma rozpocząć operację odczytu.
- buffer
- Char[]
Bufor do kopiowania danych.
- 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 zwrócona liczba może być mniejsza niż rzeczywista długość pola, jeśli GetChars
została już użyta do uzyskania znaków z pola. Może to być na przykład OleDbDataReader przy odczytywaniu dużej struktury danych do buforu. Aby uzyskać więcej informacji, zobacz SequentialAccess
ustawienie dla elementu CommandBehavior.
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ą być już tablicą znaków.