IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Methode

Definition

Liest einen Zeichendatenstrom aus dem angegebenen Spaltenoffset als Array in den Puffer, beginnend am angegebenen Pufferoffset.Reads a stream of characters from the specified column offset into the buffer as an array, starting at the given buffer offset.

public:
 long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[] buffer, int bufferoffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

Parameter

i
Int32

Die nullbasierte Ordnungszahl der Spalte.The zero-based column ordinal.

fieldoffset
Int64

Der Index in der Zeile, in der der Lesevorgang beginnen soll.The index within the row from which to start the read operation.

buffer
Char[]

Der Puffer, in den der Bytedatenstrom gelesen werden soll.The buffer into which to read the stream of bytes.

bufferoffset
Int32

Der Index für buffer für den Beginn des Lesevorgangs.The index for buffer to start the read operation.

length
Int32

Die Anzahl der zu lesenden Bytes.The number of bytes to read.

Gibt zurück

Die tatsächlich gelesene Anzahl von Zeichen.The actual number of characters read.

Ausnahmen

Der übergebene Index lag außerhalb des Bereichs von 0 bis FieldCount.The index passed was outside the range of 0 through FieldCount.

Hinweise

GetChars gibt die Anzahl der im Feld verfügbaren Zeichen zurück.GetChars returns the number of available characters in the field. Dies ist häufig die genaue Länge des Felds.Frequently this is the exact length of the field. Allerdings kann die zurückgegebene Zahl kleiner als die genaue Länge des Felds sein, wenn GetChars bereits zum Abrufen von Zeichen aus dem Feld verwendet wurde.However, the number returned may be less than the exact length of the field if GetChars has already been used to obtain characters from the field.

Wenn Sie einen Puffer übergeben, der nullist, gibt GetChars die Länge des Felds in Zeichen zurück.If you pass a buffer that is null, GetChars returns the length of the field in characters.

Es werden keine Umwandlungen durchgeführt, daher müssen die abgerufenen Daten bereits ein Zeichenarray bilden.No conversions are performed; therefore the data retrieved must already be a character array.

Gilt für: