AppendChars-Methode

Hängt die angegebene Teilmenge des angegebenen Arrays von System.Chars an den neuen Wert für die angegebene ULDbType.LongVarchar-Spalte an.

Visual Basic-Syntax

Public Sub AppendChars(
    ByVal colID As Integer,
    ByVal val As Char(),
    ByVal srcOffset As Integer,
    ByVal count As Integer
)

C#-Syntax

public void AppendChars(int colID, char[] val, int srcOffset, 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.
val Der Wert, der an den aktuellen neuen Wert für die Spalte angehängt wird.
srcOffset Die Startposition im Ausgangs-Array.
count Die Anzahl der zu kopierenden Bytes.

Die Zeichen an der Position srcOffset (beginnend bei 0) bis srcOffset+count-1 des val-Arrays werden an den Wert für die angegebene Spalte angehängt. Bei Einfügungen initialisiert ULTable.InsertBegin den neuen Wert entsprechend dem Standardwert der Spalte. Die Daten in der Zeile werden erst geändert, wenn Sie ein ULTable.Insert-Objekt ausführen. Diese Änderung ist erst dann dauerhaft, wenn sie festgeschrieben wird.

Bei der Aktualisierung löscht die erste Anhängung an eine Spalte den aktuellen Spaltenwert, bevor der neue Wert angehängt wird.

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:

val ist Null.
srcOffset ist negativ.
count ist negativ.
scrOffset +count ist größer als die val-Länge.

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

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.