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 GetChars die Länge des Feldes in Zeichen zurück.

Die Zeichen an Position srcOffset bis srcOffset+count-1 des Werts werden in 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 Zielarrays unverändert.

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

srcOffset ist negativ.
dstOffset ist negativ.
count ist negativ.
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.