GetChunk Method
Returns all or a portion of the contents of a Memo or Long Binary Field object in the Fields collection of a Recordset object.
Syntax
Set variable = recordset ! field.GetChunk (offset, numbytes)
The GetChunk method syntax has these parts.
Part | Description |
---|---|
variable | A Variant (String subtype) that receives the data from the Field object named by field. |
recordset | An object variable that represents the Recordset object containing the Fields collection. |
field | An object variable that represents a Field object whose Type property is set to dbMemo (Memo) or dbLongBinary (Long Binary). |
offset | A Long value equal to the number of bytes to skip before copying begins. |
numbytes | A Long value equal to the number of bytes you want to return. |
Remarks
The bytes returned by GetChunk are assigned to variable. Use GetChunk to return a portion of the total data value at a time. You can use the AppendChunk method to reassemble the pieces.
If offset is 0, GetChunk begins copying from the first byte of the field.
If numbytes is greater than the number of bytes in the field, GetChunk returns the actual number of remaining bytes in the field.
Caution Use a Memo field for text, and put binary data only in Long Binary fields. Doing otherwise will cause undesirable results.