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

Definice

Obor názvů:

Microsoft.Data.SqlClient.Server

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Získá hodnotu pro sloupec určený pořadovým řádem 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 -> int64

Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As Long

Parametry

ordinal

Int32

Pořadová řada sloupce založená na nule.

fieldOffset

Int64

Posun do 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é chcete začít kopírovat znaky.

length

Int32

Počet znaků, které se mají zkopírovat do vyrovnávací paměti.

Návraty

Int64

Počet zkopírovaných znaků.

Implementuje

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

Výjimky

IndexOutOfRangeException

Hodnota ordinal je menší než 0 nebo větší než počet sloupců (to znamená FieldCount).

SqlNullValueException

Sloupec zadaný parametrem ordinal má hodnotu null.

InvalidCastException

Došlo k neshodě typů.

Poznámky

Tato metoda umožňuje získat hodnotu znaku 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 char velikosti bloku a volání GetChars opakovaně upravte fieldOffset parametr v každém volání.