Метод GetChunk (ADO)

Возвращает все или часть содержимого объекта Field большого текста или двоичных данных.

Синтаксис

  
variable = field.GetChunk(Size)  

Возвращаемое значение

Возвращает значение Variant.

Параметры

Размер
Длинное выражение, равное количеству байтов или символов, которые требуется извлечь.

Комментарии

Используйте метод GetChunk для объекта Field , чтобы получить часть или все его длинные двоичные или символьные данные. В ситуациях, когда системная память ограничена, можно использовать метод GetChunk для обработки длинных значений частями, а не полностью.

Данные, возвращаемые вызовом GetChunk , назначаются переменной. Если размер больше оставшихся данных, метод GetChunk возвращает только оставшиеся данные без заполнения переменной пустыми пробелами. Если поле пустое, метод GetChunk возвращает значение NULL.

Каждый последующий вызов GetChunk извлекает данные, начиная с того места, с которого был выключен предыдущий вызов GetChunk . Однако если вы извлекаете данные из одного поля, а затем задаете или считываете значение другого поля в текущей записи, ADO предполагает, что вы завершили извлечение данных из первого поля. При повторном вызове метода GetChunk в первом поле ADO интерпретирует вызов как новую операцию GetChunk и начинает чтение с начала данных. Доступ к полям в других объектах Recordset , которые не являются клонами первого объекта Recordset , не нарушает операции GetChunk .

Если бит adFldLong в свойстве Attributes объекта Field имеет значение True, для этого поля можно использовать метод GetChunk .

Если при использовании метода GetChunk в объекте Field нет текущей записи, возникает ошибка 3021 (нет текущей записи).

Примечание

Метод GetChunk не работает с объектами Field объекта Record . Он не выполняет никаких операций и приведет к ошибке во время выполнения.

Применение

Объект Field

См. также:

Примеры методов AppendChunk и GetChunk (VB)
Примеры методов AppendChunk и GetChunk (Visual C++)
Метод AppendChunk (ADO)
Свойство Attributes (ADO)