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

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.SqlClient

Zestaw:: System.Data.SqlClient.dll

Zestaw:: System.Data.dll

Pakiet:: System.Data.SqlClient v4.9.0

Źródło:: System.Data.SqlClient.notsupported.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 przesunięcia określonej kolumny do buforu jako tablicę rozpoczynającą się od danego przesunięcia 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);

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 polu, z którego ma rozpocząć operację odczytu.

buffer: Char[]

Bufor służący do odczytywania strumienia bajtów.

bufferIndex: Int32

Indeks w obszarze, w buffer którym ma być uruchamiana operacja zapisu.

length: Int32

Maksymalna długość kopiowania do buforu.

Zwraca

Int64

Rzeczywista liczba znaków odczytanych.

Implementuje

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

Uwagi

GetChars Zwraca liczbę dostępnych znaków w polu. Często 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 SqlDataReader dużą strukturę danych do buforu. Aby uzyskać więcej informacji, zobacz SequentialAccess ustawienie dla CommandBehaviorelementu .

Rzeczywista liczba odczytanych znaków może być mniejsza niż żądana długość, jeśli osiągnięto koniec pola. W przypadku przekazania buforu, który jest null, GetChars zwraca długość całego pola w znakach, a nie pozostały rozmiar na podstawie parametru przesunięcia buforu.

Nie są wykonywane żadne konwersje; Dlatego. pobrane dane muszą być już tablicą znaków.

Uwaga

Metoda GetChars zwraca wartość 0, gdy dataIndex jest ujemna.

Dotyczy

Produkt	Wersje
.NET	Core 1.0, Core 1.1, 6 (package-provided), 7 (package-provided), 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)

Udostępnij za pośrednictwem