Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

SqlDataRecord.GetChars-Methode: (Int32, Int64, Char[], Int32, Int32)

 

Veröffentlicht: Oktober 2016

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Char-Objekten ab.

Namespace:   Microsoft.SqlServer.Server
Assembly:  System.Data (in System.Data.dll)

public virtual long GetChars(
	int ordinal,
	long fieldOffset,
	char[] buffer,
	int bufferOffset,
	int length
)

Parameter

ordinal
Type: System.Int32

Die nullbasierte Ordnungszahl der Spalte.

fieldOffset
Type: System.Int64

Der Offset im Feldwert, ab dem Zeichen abgerufen werden sollen.

buffer
Type: System.Char[]

Der Zielpuffer, in den Zeichen kopiert werden sollen.

bufferOffset
Type: System.Int32

Der Offset im Puffer, ab dem die kopierten Zeichen eingesetzt werden sollen.

length
Type: System.Int32

Die Anzahl der in den Puffer zu kopierenden Zeichen.

Rückgabewert

Type: System.Int64

Die Anzahl von kopierten Zeichen.

Exception Condition
IndexOutOfRangeException

ordinal ist kleiner als 0 oder größer als die Anzahl der Spalten (d. h. FieldCount).

SqlNullValueException

Die durch ordinal angegebene Spalte ist 0 (null).

InvalidCastException

Es liegt ein Typenkonflikt vor.

This method enables you to obtain a character value either in a single call or in chunks. Getting the value in chunks is useful for large values or values of unknown size.

To obtain the value in several chunks, allocate a char array of the chunk-size and call M:Microsoft.SqlServer.Server.SqlDataRecord.GetChars(System.Int32,System.Int64,System.Char[],System.Int32,System.Int32) repeatedly adjusting the fieldOffset parameter accordingly in each call.

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: