GetChars-Methode

Kopiert eine Untermenge des Werts für die angegebene ULDbType.LongVarchar-Spalte, beginnend beim angegebenen Offset, in das angegebene Offset des System.Char-Zielarrays.

Visual Basic-Syntax

Public Overrides Function GetChars(
    ByVal colID As Integer,
    ByVal srcOffset As Long,
    ByVal dst As Char(),
    ByVal dstOffset As Integer,
    ByVal count As Integer
) As Long

C#-Syntax

public override long GetChars(
    int colID,
    long srcOffset,
    char[] dst,
    int dstOffset,
    int count
)

Parameter

colID Die ID-Nummer der Spalte. Der Wert muss im Bereich [0,ULDataReader.FieldCount-1] liegen. Die erste Spalte im Cursor hat den ID-Wert Null.
srcOffset Die Startposition im Spaltenwert. Null ist der Anfang des Werts.
dst Das Ziel-Array
dstOffset Die Startposition im Ziel-Array
count Die Anzahl der zu kopierenden Zeichen.

Bemerkungen

Wenn Sie einen dst-Puffer übergeben, der eine Nullreferenz hat ("Nothing" in Visual Basic), gibt die GetChars-Methode die Länge des Feldes in Zeichen zurück.

Die Zeichen an den Positionen srcOffset bis srcOffset +count -1 des Werts werden an die Positionen dstOffset bis dstOffset +count -1 des Ziel-Arrays kopiert. Falls das Ende des Werts angetroffen wird, bevor count Zeichen kopiert wurden, bleibt der Rest des Ziel-Arrays unverändert.

Falls eine der folgenden Aussagen zutrifft, wird ein ULException-Objekt mit der ULSQLCode.SQLE_INVALID_PARAMETER-Konstanten ausgegeben und das Ziel wird nicht verändert:

Der srcOffset-Wert ist negativ.
Der dstOffset-Wert ist negativ.
Der count-Wert ist negativ.
Der Wert dstOffset +count ist größer als die dst-Länge.

Bei anderen Fehlern wird ein ULException-Objekt mit dem entsprechenden Fehlercode ausgegeben.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.