AppendBytes method

Appends the specified subset of the specified array of System.Bytes to the new value for the specified ULDbType.LongBinary column.

Visual Basic syntax

Public Sub AppendBytes(
     ByVal colID As Integer,
    ByVal val As Byte(),
    ByVal srcOffset As Integer,
    ByVal count As Integer
)

C# syntax

public void AppendBytes(int colID, byte[] val, int srcOffset, int count)

Parameters

colID The ID number of the column. The value must be in the range [0,ULDataReader.FieldCount-1]. The first column in the cursor has an ID value of zero.
val The value to append to the current new value for the column.
srcOffset The start position in the source array.
count The number of bytes to be copied.

Remarks

The bytes at position srcOffset (starting from 0) through srcOffset +count -1 of the array val are appended to the value for the specified column.

When inserting, ULTable.InsertBegin initializes the new value to the column's default value. The data in the row is not actually changed until you execute an ULTable.Insert, and that change is not made permanent until it is committed.

When updating, the first append on a column clears the current value prior to appending the new value.

If any of the following are true, a ULException with code ULSQLCode.SQLE_INVALID_PARAMETER is thrown and the destination is not modified:

val is null.
srcOffset is negative.
count is negative.
srcOffset +count is greater than the val length.

For other errors, a ULException with the appropriate error code is thrown.