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

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.OleDb

Zestaw:: System.Data.OleDb.dll

Zestaw:: System.Data.dll

Pakiet:: System.Data.OleDb v10.0.0-preview.1.25080.5

Źródło:: OleDbDataReader.cs

Źródło:: OleDbDataReader.cs

Źródło:: OleDbDataReader.cs

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

Int64

Rzeczywista liczba odczytanych znaków.

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. 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.

Dotyczy

Produkt	Wersje
.NET	8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)

Zobacz też

Elementy DataAdapter i DataReader

Udostępnij za pośrednictwem