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.