AppendChunk

(PWS4 IIS4 IIS5)
AppendChunk — 大きなサイズの文字列またはバイナリの Field オブジェクにデータを追加します。

構文

object.AppendChunk Data

パラメータ

object Field オブジェクトまたは Parameter オブジェクトを指定します。
Data オブジェクトに追加するデータを含むバリアント型 (Variant) のデータを指定します。

説明

Field オブジェクトの Attributes プロパティで adFldLong ビットが True (1) に設定されている場合、そのフィールドに AppendChunk メソッドを使用することができます。

Field オブジェクトで AppendChunk メソッドを最初に呼び出したときは、フィールドの既存データに上書きしてデータが書き込まれます。AppendChunk メソッドを続けて呼び出したときは、既存データに追加されます。あるフィールドにデータを追加し、その後、カレントレコードの別のフィールド値の設定または読み取りを行うと、最初のフィールドへのデータの追加は終了したと見なされます。したがって、もう一度最初のフィールドで AppendChunk メソッドを呼び出すと、新規の AppendChunk 操作と解釈され、既存データに上書きされます。最初の Recordset オブジェクトのクローン以外のほかの Recordset オブジェクトのフィールドにアクセスしても、AppendChunk 操作は中断されません。

Field オブジェクトで AppendChunk メソッドを呼び出したときにカレント レコードが存在しない場合、エラーが発生します。

注意 AppendChunk メソッドでは、Record オブジェクトの Field オブジェクトを操作することはできません。操作は何も実行されず、実行時エラーが発生します。