GetChunk メソッド (ADO)

適用先: Access 2013、Office 2013

サイズの大きいテキスト データやバイナリ データの Field オブジェクトから、内容の全体または一部を返します。

構文

変数 = フィールド。GetChunk(Size )

戻り値

バリアント型 (Variant) の値を返します。

パラメーター

パラメーター	説明
サイズ	取得するバイト数または文字数と等しい長整数型 ( Long ) の式を指定します。

注釈

Field オブジェクトの GetChunk メソッドを使用すると、長いバイナリ データまたは文字データの一部または全体を取得できます。 システムのメモリ容量が少ない場合、 GetChunk メソッドを使用して、長い値の全体ではなく一部を操作できます。

GetChunk への呼び出しによって返される値は、variable に格納されます。 Size が残りのデータよりも大きい場合、GetChunk メソッドは、variable の余った部分を空白で埋めることはなく、残りのデータのみを返します。 フィールドが空の場合、 GetChunk メソッドは Null 値を返します。

GetChunk を連続して呼び出すと、直前の GetChunk の呼び出しで取得されたデータの直後からデータが取得されます。 ただし、あるフィールドのデータを取得しているときに、カレント レコードの別のフィールド値の設定または読み取りを行うと、最初のフィールドからのデータ取得は終了したと見なされます。 最初のフィールドでもう一度 GetChunk メソッドを呼び出すと、新規の GetChunk 操作と解釈され、データ先頭から読み取りが開始されます。 最初の Recordset オブジェクトの複製を除く別の Recordset オブジェクトのフィールドにアクセスした場合、 GetChunk 操作は中断されません。

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

Field オブジェクトで GetChunk メソッドを使用する際にカレント レコードがないと、エラー 3021 (カレント レコードがありません) が発生します。

注:

[!メモ] GetChunk メソッドでは、 Record オブジェクトの Field オブジェクトを操作できません。 操作は何も実行されず、実行時エラーが発生します。