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

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.Odbc
Zestaw:
System.Data.Odbc.dll
Zestaw:
System.Data.dll

Odczytuje strumień znaków z przesunięcia określonej kolumny do buforu jako tablicy, rozpoczynają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 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);
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 (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parametry

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

Int64

Rzeczywista liczba znaków odczytanych.

Implementuje

GetChars(Int32, Int64, Char[], Int32, Int32)

Uwagi

GetChars Zwraca liczbę dostępnych znaków w polu. W większości przypadków jest to dokładna długość pola. Zwracana liczba może być jednak 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 przypadek, jeśli odczytuje OdbcDataReader 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.

Uwaga

Nie zostanie zgłoszony wyjątek, jeśli wartość elementu bufferIndex znajduje się poza tablicą. Nie zostaną odczytane żadne dane, a metoda zwróci wartość 0.

Dotyczy

Zobacz też