Share via


SqlCeResultSet.GetChars-Methode

Kopiert eine Zeichenlänge in den Puffer, beginnend bei einer angegebenen Position im angegebenen Feld.

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Syntax

'Declaration
Public Overrides Function GetChars ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
'Usage
Dim instance As SqlCeResultSet
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetChars(ordinal, _
    dataIndex, buffer, bufferIndex, length)
public override long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
override GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
public override function GetChars(
    ordinal : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

Parameter

  • ordinal
    Typ: System.Int32
    Die Ordinalposition des Felds, aus dem Daten abgerufen werden sollen.
  • dataIndex
    Typ: System.Int64
    Der Offset (in Zeichen) in dem Feld, in dem der Kopiervorgang beginnen soll.
  • buffer
    Typ: array<System.Char[]
    Der Puffer, in den die Daten kopiert werden sollen.
  • bufferIndex
    Typ: System.Int32
    Der Offset im Puffer, in dem mit dem Kopiervorgang begonnen werden soll.
  • length
    Typ: System.Int32
    Die maximale Anzahl der zu kopierenden Bytes.

Rückgabewert

Typ: System.Int64
Die tatsächliche Anzahl kopierter Zeichen.

Implementiert

IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)

Hinweise

Diese Funktion gibt die tatsächliche Anzahl kopierter Zeichen zurück. Diese Anzahl kann geringer sein als die angeforderte Länge, wenn das Ende des Felds erreicht ist.

Wenn ein Puffer übergeben wird, der NULL ist, gibt GetChars die Länge des Felds in Zeichen zurück.

Wenn der Befehl mit dem Befehlsverhalten SequentialAccess ausgeführt wird, müssen Aufrufe von GetChars sequenziell steigende Lesevorgänge angeben, andernfalls wird eine Ausnahme ausgelöst.

Es wird eine Ausnahme ausgelöst, wenn an der angegebenen Ordinalposition kein Feld vorhanden ist.

Siehe auch

Verweis

SqlCeResultSet Klasse

System.Data.SqlServerCe-Namespace