OleDbDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přečte datový proud znaků ze zadaného posunu sloupce do vyrovnávací paměti jako pole počínaje daným posunem vyrovnávací paměti.
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
Řadový sloupec založený na nule.
- dataIndex
- Int64
Index v řádku, ze kterého se má spustit operace čtení.
- buffer
- Char[]
Vyrovnávací paměť, do které se mají 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
Skutečný počet přečtených znaků.
Implementuje
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 OleDbDataReader objekt čte velkou datovou strukturu do vyrovnávací paměti. Další informace najdete v SequentialAccess
nastavení pro CommandBehavior.
Pokud předáte vyrovnávací paměť, která je null
, GetChars vrátí délku pole ve znach.
Nejsou provedeny žádné převody; Proto načtená data již musí být pole znaků.