大きなテキストまたはバイナリ データ の Field オブジェクトの内容のすべてまたは一部を返します。
構文
variable = field.GetChunk(Size)
戻り値
バリアント型 (Variant) の値を返します。
パラメーター
サイズ
取得するバイト数または文字数に等しい Long 式。
注釈
Field オブジェクトの GetChunk メソッドを使用して、長いバイナリデータまたは文字データの一部またはすべてを取得します。 システム メモリが制限されている場合は、GetChunk メソッドを使用して、全体ではなく、一部の長い値を操作できます。
GetChunk 呼び出しから返されるデータは、変数 割り当てられます。 Size が残りのデータより大きい場合、GetChunk メソッドは、空のスペースで変数 埋め込まずに残りのデータのみを返します。 フィールドが空の場合、GetChunk メソッドは null 値を返します。
それぞれの後続の GetChunk 呼び出しは、前の GetChunk 呼び出しが終了した地点からデータを取得します。 ただし、あるフィールドからデータを取得し、現在のレコード内の別のフィールドの値を設定または読み取る場合、ADO では最初のフィールドからのデータの取得が完了したと見なされます。 最初のフィールドで GetChunk メソッドを再度呼び出すと、ADO はその呼び出しを新しい GetChunk 操作として解釈し、データの先頭から読み取りを始めます。 最初の Recordset オブジェクトのクローンではない他の Recordset オブジェクトのフィールドにアクセスしても、GetChunk 操作は中断されません。
Field オブジェクトの Attributes プロパティの adFldLong ビットが True に設定されている場合は、そのフィールドに対して GetChunk メソッドを使用できます。
Field オブジェクトで GetChunk メソッドを使用するときに現在のレコードがない場合、エラー 3021 (現在のレコードなし) が発生します。
注
GetChunk メソッドは、Record オブジェクトの Field オブジェクトに対して動作しません。 操作は実行されず、実行時エラーが発生します。
適用対象
こちらもご覧ください
AppendChunk メソッドと GetChunk メソッドの使用例 (VB)
AppendChunk メソッドと GetChunk メソッドの例 (VC++)
AppendChunk メソッド (ADO)
Attributes プロパティ (ADO)