Freigeben über


SqlCeDataReader.GetChars-Methode

Liest beginnend am angegebenen Pufferoffset einen Datenstrom von Zeichen aus dem angegebenen Spaltenoffset in den Puffer eines Arrays.

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

Syntax

'Declaration
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
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 SqlCeDataReader
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)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public override long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
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 nullbasierte Ordnungszahl der Spalte.
  • dataIndex
    Typ: System.Int64
    Der Index in der Zeile, an dem der Lesevorgang beginnen soll.
  • buffer
    Typ: array<System.Char[]
    Der Puffer, in den Daten kopiert werden sollen.
  • bufferIndex
    Typ: System.Int32
    Der Index für buffer, an dem der Lesevorgang beginnen soll.
  • length
    Typ: System.Int32
    Die Anzahl der zu lesenden Zeichen.

Rückgabewert

Typ: System.Int64
Die tatsächlich gelesene Anzahl von Zeichen.

Implementiert

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

Ausnahmen

Ausnahme Bedingung
InvalidOperationException

Der Vorgang ist ungültig. Die SqlCeDataReader-Klasse ist möglicherweise hinter der letzten Zeile im Resultset positioniert.

Hinweise

Die GetChars-Methode gibt die Anzahl der verfügbaren Zeichen im Feld zurück. In den meisten Fällen ist dies die genaue Länge des Felds. Die zurückgegebene Anzahl kann jedoch kleiner als die tatsächliche Länge des Felds sein, wenn die GetChars-Methode bereits zum Abrufen von Zeichen aus dem Feld verwendet wurde. Dies kann z. B. der Fall sein, wenn der SqlCeDataReader eine umfangreiche Datenstruktur in einen Puffer liest. Weitere Informationen finden Sie unter der SequentialAccess-Einstellung für CommandBehavior.

Wenn Sie einen Puffer übergeben, der nullein NULL-Verweis (Nothing in Visual Basic) ist, gibt die GetChars-Methode die Länge des Felds in Zeichen zurück.

Es werden keine Konvertierungen durchgeführt, daher müssen die abgerufenen Daten bereits als Zeichenarray vorliegen.

Siehe auch

Verweis

SqlCeDataReader Klasse

System.Data.SqlServerCe-Namespace