AppendBytes-Methode

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

Syntax

Visual Basic
Public Sub AppendBytes( _
   ByVal columnID As Integer, _
   ByVal val As Byte(), _
   ByVal srcOffset As Integer, _
   ByVal count As Integer _
)

C#
public void AppendBytes(
   int columnID,
   byte[] val,
   int srcOffset,
   int count
);

Parameter

columnID 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

Bemerkungen

Die Bytes an der Position srcOffset (beginnend bei 0) bis srcOffsetcount-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.
srcOffset+count ist größer als val.Length.

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

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.
Senden Sie uns Feedback über diese Seite via E-Mail.