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

Definice

Obor názvů:

Microsoft.SqlServer.Server

Sestavení:

System.Data.SqlClient.dll

Balíček:

System.Data.SqlClient v4.8.5

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 -> 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é čí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

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 určený parametrem ordinal má hodnotu null.

InvalidCastException

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í.