ADO Field Object AppendChunk Method

You are here: ADO Component Reference > ADO Objects > ADO Field Object > ADO Field Object Methods > ADO Field Object AppendChunk Method

ADO Field Object AppendChunk Method

Appends data to a large text or binary data Field object.

AppendChunk Method Syntax (ADO Field Object)

object.AppendChunk Data

AppendChunk Method Parameters (ADO Field Object)

object

A Field object.

Data

A Variant containing the data you want to append to the object.

AppendChunk Method Remarks (ADO Field Object)

Use the AppendChunk method on a Field object to fill it with long binary or character data. In situations where system memory is limited, you can use the AppendChunk method to manipulate long values in portions rather than in their entirety.

If the adFldLong bit in the ADO Field Object Attributes Property of a Field object is set to True, you can use the AppendChunk method for that field.

The first AppendChunk call on a Field object writes data to the field, overwriting any existing data. Subsequent AppendChunk calls add to existing data. If you are appending data to one field and then you set or read the value of another field in the current record, ADO assumes that you are done appending data to the first field. If you call the AppendChunk method on the first field again, ADO interprets the call as a new AppendChunk operation and overwrites the existing data. Accessing fields in other ADO Recordset Object objects (that are not clones of the first Recordset object) will not disrupt AppendChunk operations.

If there is no current record when you call AppendChunk on a Field object, an error occurs.

AppendChunk Method Examples (ADO Field Object)

See the ADO Field Object GetChunk Method example.