AppendChars method

Appends the specified subset of the specified array of System.Chars to the new value for the specified ULDbType.LongVarchar column.

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)

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.

The characters 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 is 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 value length.

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