GetChunk 方法 (ADO)

傳回大型文字或二進位資料 Field 物件的所有或部分內容。

語法

  
variable = field.GetChunk(Size)  

傳回值

傳回 Variant。

參數

大小
Long 運算式，等於您所要擷取的位元組數或字元數。

備註

在 Field 物件上使用 GetChunk 方法來擷取部分或全部的長二進位或字元資料。 在系統記憶體有限的情況下，您可以使用 GetChunk 方法來操作部分的長值，而不是整個長值。

GetChunk 呼叫傳回的資料會指派給 variable。 如果 Size 大於剩餘的資料，GetChunk 方法只會傳回剩餘的資料，而不使用空格填補 variable。 如果欄位是空的，GetChunk 方法就會傳回 Null 值。

每個後續的 GetChunk 呼叫都會從先前 GetChunk 呼叫離開的位置開始擷取資料。 不過，如果您要從某個欄位擷取資料，然後設定或讀取目前記錄中另一個欄位的值，則 ADO 會假設您已完成從第一個欄位擷取資料。 如果您再次在第一個欄位上呼叫 GetChunk 方法，ADO 會將呼叫解譯為新的 GetChunk 作業，並從資料開頭開始讀取。 存取其他 Recordset 物件中不是第一個 Recordset 物件複製的欄位，將不會中斷 GetChunk 作業。

如果 Field 物件 Attributes 屬性中的 adFldLong 位元設定為 True，您就可以針對該欄位使用 GetChunk 方法。

如果您在 Field 物件上使用 GetChunk 方法時沒有目前的記錄，則會發生錯誤 3021 (沒有目前的記錄)。

注意

GetChunk 方法無法在 Record 物件的 Field 物件上運作。 其不會執行任何作業，而且會產生執行階段錯誤。

套用至

Field 物件

另請參閱

AppendChunk 和 GetChunk 方法範例 (VB)
AppendChunk 和 GetChunk 方法範例 (VC++)
AppendChunk 方法 (ADO)
Attributes 屬性 (ADO)