Field 大きなテキストまたはバイナリ データ、または Parameter オブジェクトにデータを追加します。
構文
object.AppendChunk Data
パラメーター
オブジェクト
Field オブジェクトまたは Parameter オブジェクト。
データ
オブジェクトに追加するデータを格納する バリアント型 (Variant )。
注釈
Field オブジェクトまたは Parameter オブジェクトの AppendChunk メソッドを使用して、長いバイナリデータまたは文字データを格納します。 システム メモリが制限されている場合は、AppendChunk メソッドを使用して、全体ではなく、一部の長い値を操作できます。
フィールド
Field オブジェクトの Attributes プロパティの adFldLong ビットが true に設定されている場合は、そのフィールドに AppendChunk メソッドを使用できます。
Field オブジェクトの最初の AppendChunk 呼び出しは、既存のデータを上書きしてフィールドにデータを書き込みます。 その後 AppendChunk 呼び出しが既存のデータに追加されます。 あるフィールドにデータを追加し、現在のレコード内の別のフィールドの値を設定または読み取る場合、ADO では、最初のフィールドへのデータの追加が完了していることを前提としています。 最初のフィールドで AppendChunk メソッドをもう一度呼び出すと、ADO は新しい AppendChunk 操作として呼び出しを解釈し、既存のデータを上書きします。 他の Recordset オブジェクトのフィールドにアクセスしても、最初の Recordset オブジェクトのクローンではないこれらのオブジェクトは、AppendChunk 操作を中断することはありません。
Field オブジェクトで AppendChunk を呼び出すときに現在のレコードがない場合は、エラーが発生します。
注
AppendChunk メソッドは、Record オブジェクト (ADO) オブジェクトの Field オブジェクトに対して動作しません。 操作は実行されず、実行時エラーが発生します。
パラメーター
Parameter オブジェクトの Attributes プロパティの adParamLong ビットが true に設定されている場合は、そのパラメーターに AppendChunk メソッドを使用できます。
Parameter オブジェクトに対する最初の AppendChunk 呼び出しは、既存のデータを上書きして、パラメーターにデータを書き込みます。 Parameter オブジェクトに対する後続の AppendChunk 呼び出しは、既存のパラメーター データに追加されます。 null 値を渡す AppendChunk 呼び出しは、すべてのパラメーター データを破棄します。
適用対象
こちらもご覧ください
AppendChunk メソッドと GetChunk メソッドの使用例 (VB)
AppendChunk メソッドと GetChunk メソッドの例 (VC++)
Attributes プロパティ (ADO)
GetChunk メソッド (ADO)