SqlDataRecord.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í.
Získá hodnotu pro sloupec určený pořadovým číslo jako pole Char objektů.
public:
virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As LongParametry
- ordinal
- Int32
Pořadové číslo sloupce založené na nule.
- fieldOffset
- Int64
Posun hodnoty pole, aby se začaly načítat znaky.
- buffer
- Char[]
Cílová vyrovnávací paměť, do které se mají kopírovat znaky.
- bufferOffset
- Int32
Posun do vyrovnávací paměti, do které se mají začít kopírovat znaky.
- length
- Int32
Počet znaků, které se mají zkopírovat do vyrovnávací paměti.
Návraty
Počet zkopírovaných znaků
Implementuje
Výjimky
Hodnota ordinal je menší než 0 nebo větší než počet sloupců (to znamená FieldCount).
Sloupec určený parametrem ordinal má hodnotu null.
Došlo k neshodě typů.
Poznámky
Tato metoda umožňuje získat hodnotu znaku buď v jednom volání, nebo v blocích. Získání hodnoty v blocích je užitečné pro velké hodnoty nebo hodnoty neznámé velikosti.
Chcete-li získat hodnotu v několika blocích, přidělte pole znaků velikosti bloku a volání GetChars opakovaně upravte fieldOffset parametr v každém volání.