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í.
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:
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 chcete spustit operaci čtení.
- buffer
- Char[]
Vyrovnávací paměť, do které chcete kopírovat data.
- bufferIndex
- Int32
Index v rámci buffer , kde se má operace zápisu spustit.
- 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 v případě, že OleDbDataReader čte velkou datovou strukturu do vyrovnávací paměti. Další informace naleznete v SequentialAccess nastavení pro CommandBehavior.
Pokud předáte vyrovnávací paměť, která je null, GetChars vrátí délku pole v znaky.
Neprovádí se žádné převody; proto data načtená již musí být znakovou maticí.