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

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.dll

Načte datový proud znaků ze zadaného posunu sloupce do vyrovnávací paměti jako pole začínající na daném posunu vyrovnávací paměti.

public:
 virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public 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);
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parametry

i
Int32

Řadový sloupec založený na nule.

dataIndex
Int64

Index v poli, ze kterého chcete zahájit operaci čtení.

buffer
Char[]

Vyrovnávací paměť, do které se má číst datový proud bajtů.

bufferIndex
Int32

Index v rámci buffer , kde se má operace zápisu spustit.

length
Int32

Maximální délka kopírování do vyrovnávací paměti.

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. Často 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 v případě, že SqlDataReader čte velkou datovou strukturu do vyrovnávací paměti. Další informace naleznete v SequentialAccess nastavení pro CommandBehavior.

Skutečný počet přečtených znaků může být menší než požadovaná délka, pokud je dosaženo konce pole. Pokud předáte vyrovnávací paměť, která je null, GetChars vrátí délku celého pole ve znacích, nikoli zbývající velikost na základě parametru posunu vyrovnávací paměti.

Neprovádí se žádné převody; Proto. načtená data již musí být polem znaků.

Note

Metoda GetChars vrátí hodnotu 0, pokud dataIndex je záporná.

Platí pro

Viz také