appendBytes 方法

将指定的字节数组的指定子集添加到指定的 SQLType.LONGBINARY 列的新值中。

语法

appendBytes(
  UInt16 columnID, 
  Array value, 
  UInt32 srcOffset, 
  UInt32 count
)

参数

columnID 列的 ID 号。表中第一列的 ID 值为 1。
value 列的新值。
srcOffset 要附加到列的当前新值中的值。
count 要复制的字节数。

注释

数组 value 从 srcOffset（从 0 开始）位置到 srcOffset+count-1 位置的字节会添加到指定列的值中。在插入时，insertBegin 将新值初始化为列的缺省值。直到执行 insert 之后，才实际更改行中的数据，而且在提交之前该更改不是永久更改。

如果以下任何一个条件为 true，则抛出代码为 SQLCode.SQLE_INVALID_PARAMETER 的错误，并且不会修改目标：

value 参数为空值。
srcOffset 参数为负值。
count 参数为负值。
srcOffset+count 大于源数组的长度 value.length。

对于其它错误，抛出具有相应错误代码的 SQLException。