Метод Append (ADO)

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

Синтаксис

  
collection.Append object  
fields.Append Name, Type, DefinedSize, Attrib, FieldValue  

Параметры

набор
Объект коллекции.

поля
Коллекция Fields .

object
Объектная переменная, представляющая объект, который необходимо добавить.

имя;
Строковое значение, содержащее имя нового объекта field и не должно совпадать с именем любого другого объекта в полях.

Тип
Значение дататипинум , значение по умолчанию которого равно адемпти, которое указывает тип данных нового поля. Следующие типы данных не поддерживаются ADO и не должны использоваться при добавлении новых полей в объект Recordset (ADO): адидиспатч, адиункновн, адвариант.

DefinedSize
Необязательный параметр. Значение типа Long , представляющее определенный размер (в символах или байтах) нового поля. Значение по умолчанию для этого параметра является производным от типа. Поля с DefinedSize размером более 255 байт рассматриваются как столбцы переменной длины. Значение по умолчанию для DefinedSize не указано.

Атрибуты
Необязательный элемент. Значение фиелдаттрибутинум , для которого значение по умолчанию — адфлддефаулт, определяющее атрибуты для нового поля. Если это значение не указано, поле будет содержать атрибуты, производные от типа.

FieldValue
Необязательный параметр. Вариант , представляющий значение для нового поля. Если не указано, то поле добавляется со значением NULL.

Комментарии

Коллекция Parameters

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

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

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

Коллекция Fields

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

Примечание

Для новых объектов field , которые были добавлены к коллекции Fields объекта Record , необходимо задать свойство value , прежде чем можно будет указать другие свойства поля . Во-первых, конкретное значение свойства value должно быть назначено и Обновлено в коллекции Fields с именем. Затем можно получить доступ к другим свойствам, например к типу или атрибутам . Объекты полей следующих типов данных (дататипинум) не могут быть добавлены в коллекцию Fields , и это приведет к ошибке: адаррай, адчаптер, адемпти, адпропвариант и адусердефинед. Кроме того, следующие типы данных не поддерживаются ADO: адидиспатч, адиункновн и адивариант. Для этих типов ошибка не будет возникать при добавлении, но использование может привести к непредсказуемым результатам, включая утечки памяти.

набор записей

Если не задать свойство CursorLocation перед вызовом метода append , CursorLocation будет иметь значение адусеклиент ( курсорлокатионенум Value) автоматически при вызове метода открытия объекта Recordset .

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

Record

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

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

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

Применяется к

См. также:

Примеры методов Append и CreateParameter (Visual Basic)
Пример методов Append и CreateParameter (VC++)
Метод CreateParameter (ADO)
Метод Delete (коллекция полей ADO)
Метод Delete (Коллекция параметров ADO)
Метод Delete (набор записей ADO)
Метод Update