GetChunkByte Method

Example

Applies To

OraField Object

Description

Read the data from the long or long raw field into byte array and returns the size of data read.

Usage

Size_read = orafield.GetChunkByte( ByteArray, offset, numbytes)

Arguments

ByteArray	the first element of the ByteArray which will hold the data
offset	the number of bytes of the field to skip before copying data
numbytes	the number of bytes to copy

Remarks

When possible, GetChunkByte retrieves the specified bytes from the local cache. However, to conserve resources, some of the data might not be stored locally. In these cases, GetChunkByte requests the necessary data from the database as required. As part of this process, data from all fields (except the Long or Long Raw field) in the dynaset are retrieved and compared with the cached values for consistency. If any changes have occurred since the fetch of the original partial data, then GetChunkByte aborts the operation with an error. In the case of an abort, the returned string is NULL.

If a long or long raw field is less than 64KB in size, it is quicker to retrieve the data using the Value property than using GetChunkByte. You cannot use GetChunkByte on a long or long raw field that you have aliased.

See Migration from Long Raw to LOB/BFILE for additional information.