Метод Append (ADO)

Область применения: Access 2013, Office 2013

Добавляет объект в коллекцию. Если коллекция имеет значение Fields, перед его добавлением в коллекцию можно создать новый объект Field .

Синтаксис

коллекция. Добавить объект

поля. Append Name, Type, DefinedSize, Attrib, FieldValue

Параметры

Параметр	Описание
Коллекции	Объект коллекции.
fields	Коллекция Fields .
object	Переменная объекта, представляющая добавляемый объект.
Название	Строковое значение, содержащее имя нового объекта Field и не должно совпадать с именем любого другого объекта в полях.
Тип	Значение DataTypeEnum , значение по умолчанию — adEmpty, указывающее тип данных нового поля. Следующие типы данных не поддерживаются ADO и не должны использоваться при добавлении новых полей в набор записей: adIDispatch, adIUnknown, adVariant.
DefinedSize	Необязательный параметр. Значение Типа Long, представляющее определенный размер (в символах или байтах) нового поля. Значение по умолчанию для этого параметра является производным от Типа. Поля с definedSize больше 255 байт и обрабатываются как столбцы переменной длины. (Значение по умолчанию DefinedSize не указано.)
Attrib	Необязательный параметр. Значение FieldAttributeEnum , значение по умолчанию которого — adFldDefault, указывающее атрибуты для нового поля. Если это значение не указано, поле будет содержать атрибуты, производные от Type.
FieldValue	Необязательный параметр. Значение Variant, представляющее значение для нового поля. Если значение не указано, к полю добавляется значение NULL.

Замечания

Коллекция Parameters

Перед добавлением его в коллекцию Parameters необходимо задать свойство Type объекта Parameter. При выборе типа данных переменной длины необходимо также задать для свойства Size значение больше нуля.

Самостоятельное описание параметров сводит к минимуму вызовы к поставщику и, следовательно, повышает производительность при использовании хранимых процедур или параметризованных запросов. Однако необходимо знать свойства параметров, связанных с хранимой процедурой или параметризованным запросом, который требуется вызвать.

Используйте метод CreateParameter для создания объектов Parameter с соответствующими параметрами свойств и используйте метод Append , чтобы добавить их в коллекцию Parameters . Это позволяет задавать и возвращать значения параметров без вызова поставщика для сведений о параметрах. При записи в поставщик, который не предоставляет сведения о параметрах, необходимо использовать этот метод для заполнения коллекции Parameters вручную, чтобы использовать параметры.

Коллекция Fields

Параметр FieldValue действителен только при добавлении объекта Field в объект Record , а не в объект Recordset . С помощью объекта Record можно одновременно добавлять поля и предоставлять значения. При использовании объекта Recordset необходимо создать поля, пока набор записей закрыт, а затем открыть набор записей и присвоить значения полям.

Примечание.

Для новых объектов Field , добавленных в коллекцию Fields объекта Record , свойство Value необходимо задать перед указанием других свойств Field . Во-первых, необходимо назначить определенное значение для свойства Value и обновить в коллекции Fields . Затем можно получить доступ к другим свойствам, таким как Тип или Атрибуты .

Объекты field следующих типов данных (DataTypeEnum) не могут быть добавлены в коллекцию Fields и вызовут ошибку: adArray, adChapter, adEmpty, adPropVariant и adUserDefined. Кроме того, ADO не поддерживает следующие типы данных: adIDispatch, adIUnknown и adIVariant. При добавлении этих типов ошибок не возникнет, но использование может привести к непредсказуемым результатам, включая утечку памяти.

Recordset

Если не задать свойство CursorLocation перед вызовом метода Append, при вызове метода Open объекта RecordsetcursorLocation будет автоматически задано значение adUseClient (значение CursorLocationEnum).

Ошибка во время выполнения возникнет, если метод Append вызывается в коллекции Fields открытого набора записей или в наборе записей , где задано свойство ActiveConnection . Поля можно добавлять только в набор записей , который не открыт и еще не подключен к источнику данных. Обычно это происходит, когда объект Recordset создается с помощью метода CreateRecordset или назначается переменной объекта.

Запись

Ошибка во время выполнения не возникнет, если метод Append вызывается в коллекции Fields открытой записи. Новое поле будет добавлено в коллекцию Fields объекта Record. Если запись является производным от набора записей, то новое поле не будет отображаться в коллекции Fields объекта Recordset.

Несуществующее поле можно создать и добавить в коллекцию Fields , назначив объекту поля значение, как если бы оно уже существовало в коллекции. Назначение активирует автоматическое создание и добавление объекта Field , после чего назначение будет завершено.

После добавления поля в коллекцию Fields объекта Record вызовите метод Update коллекции Fields, чтобы сохранить изменение.