ADO AppendChunk メソッド

定義と使用方法

AppendChunk は、大きなテキストやバイナリデータの Field にデータを追加したり、Parameter オブジェクトにデータを追加するために使用されます。

ヒント:Field や Parameter オブジェクトの AppendChunk メソッドを使用して、長いバイナリや文字データでフィルを埋めます。システムメモリが限られている場合、AppendChunk メソッドを使用して Long 値の一部ではなくすべてを操作できます。

オブジェクト AppendChunk メソッドの説明
Parameter

Parameter オブジェクトの Attributes 属性の adFldLong フラグが True に設定されている場合、そのパラメータに対して AppendChunk メソッドを使用できます。

Parameter オブジェクト上の最初の AppendChunk 調用はデータをパラメータに書き込んで、既存のデータをオーバーライドします。Parameter オブジェクト上の後続の AppendChunk 調用は既存のパラメータデータにデータを追加します。Null 値の AppendChunk 調用はすべてのパラメータデータを放棄します。

Field

Field オブジェクトの Attributes 属性の adFldLong フラグが True に設定されている場合、AppendChunk メソッドを使用できます。

Field オブジェクト上の最初の AppendChunk 調用はデータをフィールドに書き込んで、既存のデータをオーバーライドします。その後の AppendChunk 調用は既存のデータにデータを追加します。データをフィールドに追加して、現在のレコードで他のフィールドの値を設定または読み取る場合、ADO は最初のフィールドにデータを追加したと認識します。最初のフィールドで再度 AppendChunk メソッドを呼び出すと、ADO はその呼び出しを新しい AppendChunk 操作と解釈し、既存のデータをオーバーライドします。最初の Recordset オブジェクト(コピーではない)のフィールドにアクセスすることは、AppendChunk 操作を中断しません。

Field オブジェクト上で AppendChunk を呼び出した場合、現在のレコードがないとエラーが発生します。

注意:AppendChunk メソッドは Record オブジェクトの Field オブジェクトに対して機能しません。何も行わず実行時エラーが発生します。

文法

objectname.AppendChunk data
パラメータ 説明
data データをオブジェクトに追加するための Variant。