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

  • Reference

Definice

Obor názvů:
System.Data.Odbc
Sestavení:
System.Data.Odbc.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.Odbc v6.0.0
Balíček:
System.Data.Odbc v7.0.0
Balíček:
System.Data.Odbc v8.0.0
Balíček:
System.Data.Odbc v9.0.0-preview.2.24128.5
Zdroj:
OdbcDataReader.cs
Zdroj:
OdbcDataReader.cs
Zdroj:
OdbcDataReader.cs

Načte stream znaků ze zadaného posunu sloupce do vyrovnávací paměti jako pole počínaje konkrétním posunem vyrovnávací paměti.

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

Pořadové číslo sloupce založené na nule.

dataIndex
Int64

Index v řádku, kde má být spuštěna operace čtení.

buffer
Char[]

Vyrovnávací paměť, do které chcete kopírovat data.

bufferIndex
Int32

Index v rámci místa, buffer kde má být spuštěna operace zápisu.

length
Int32

Počet znaků, které se mají přečíst.

Návraty

Int64

Skutečný počet přečtených znaků.

Implementuje

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

Poznámky

GetChars vrátí počet dostupných znaků v poli. Většinou se jedná o přesnou délku pole. Vrácené číslo však může být menší než skutečná délka pole, pokud GetChars již bylo použito k získání znaků z pole. To může být například případ, kdy OdbcDataReader objekt načítá velkou datovou strukturu do vyrovnávací paměti. Další informace najdete v SequentialAccess nastavení pro CommandBehavior.

Pokud předáte vyrovnávací paměť, která má hodnotu null, GetChars vrátí délku pole ve znach.

Převody se provádějí na základě základních schopností ovladače ODBC. Pokud převod není podporován, volání metody selže.

Poznámka

Pokud je hodnota bufferIndex mimo pole, nevyvolá se žádná výjimka. Nebudou načtena žádná data a metoda vrátí hodnotu 0.

Platí pro

Viz také