Метод Append (ADO)Append Method (ADO)

Добавляет объект в коллекцию.Appends an object to a collection. Если коллекция является полями, то перед добавлением в коллекцию можно создать новый объект поля .If the collection is Fields, a new Field object can be created before it is appended to the collection.

СинтаксисSyntax

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

ПараметрыParameters

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

поляfields
Коллекция Fields .A Fields collection.

objectobject
Объектная переменная, представляющая объект, который необходимо добавить.An object variable that represents the object to be appended.

имя;Name
Строковое значение, содержащее имя нового объекта field и не должно совпадать с именем любого другого объекта в полях.A String value that contains the name of the new Field object, and must not be the same name as any other object in fields.

ТипType
Значение дататипинум , значение по умолчанию которого равно адемпти, которое указывает тип данных нового поля.A DataTypeEnum value, whose default value is adEmpty, that specifies the data type of the new field. Следующие типы данных не поддерживаются ADO и не должны использоваться при добавлении новых полей в объект Recordset (ADO): адидиспатч, адиункновн, адвариант.The following data types are not supported by ADO, and should not be used when appending new fields to a Recordset Object (ADO): adIDispatch, adIUnknown, adVariant.

DefinedSizeDefinedSize
Необязательный элемент.Optional. Значение типа Long , представляющее определенный размер (в символах или байтах) нового поля.A Long value that represents the defined size, in characters or bytes, of the new field. Значение по умолчанию для этого параметра является производным от типа.The default value for this parameter is derived from Type. Поля с DefinedSize размером более 255 байт рассматриваются как столбцы переменной длины.Fields that have a DefinedSize greater than 255 bytes are treated as variable length columns. Значение по умолчанию для DefinedSize не указано.The default for DefinedSize is unspecified.

АтрибутыAttrib
Необязательный элемент.Optional. Значение фиелдаттрибутинум , для которого значение по умолчанию — адфлддефаулт, определяющее атрибуты для нового поля.A FieldAttributeEnum value, whose default value is adFldDefault, that specifies attributes for the new field. Если это значение не указано, поле будет содержать атрибуты, производные от типа.If this value is not specified, the field will contain attributes derived from Type.

FieldValueFieldValue
Необязательный элемент.Optional. Вариант , представляющий значение для нового поля.A Variant that represents the value for the new field. Если не указано, то поле добавляется со значением NULL.If not specified, the field is appended with a null value.

RemarksRemarks

Коллекция ParametersParameters Collection

Необходимо задать свойство Type объекта Parameter , прежде чем добавлять его в коллекцию Parameters .You must set the Type property of a Parameter object before appending it to the Parameters collection. Если выбран тип данных переменной длины, необходимо также задать для свойства size значение больше нуля.If you select a variable-length data type, you must also set the Size property to a value greater than zero.

Описание параметров самостоятельно сокращает число вызовов к поставщику и, таким образом, повышает производительность при использовании хранимых процедур или параметризованных запросов.Describing parameters yourself minimizes calls to the provider and therefore improves performance when you use stored procedures or parameterized queries. Однако необходимо иметь представление о свойствах параметров, связанных с хранимой процедурой или параметризованным запросом, которые необходимо вызвать.However, you must know the properties of the parameters associated with the stored procedure or parameterized query that you want to call.

Используйте метод CreateParameter для создания объектов параметров с соответствующими параметрами свойств и используйте метод append , чтобы добавить их в коллекцию Parameters .Use the CreateParameter method to create Parameter objects with the appropriate property settings and use the Append method to add them to the Parameters collection. Это позволяет задавать и возвращать значения параметров без вызова поставщика для сведений о параметрах.This lets you set and return parameter values without having to call the provider for the parameter information. При записи в поставщик, который не предоставляет сведения о параметрах, необходимо использовать этот метод, чтобы вручную заполнить коллекцию Parameters , чтобы использовать параметры.If you are writing to a provider that does not supply parameter information, you must use this method to manually populate the Parameters collection in order to use parameters at all.

Коллекция FieldsFields Collection

Параметр FieldValue допустим только при добавлении объекта поля в объект Record , а не в объект набора записей .The FieldValue parameter is only valid when adding a Field object to a Record object, not to a Recordset object. С объектом Record можно добавлять поля и предоставлять значения одновременно.With a Record object, you can append fields and provide values at the same time. При использовании объекта Recordset необходимо создать поля, пока набор записей будет закрыт, а затем открыть набор записей и присвоить значения полям.With a Recordset object, you must create fields while the Recordset is closed, and then open the Recordset and assign values to the fields.

Примечание

Для новых объектов field , которые были добавлены к коллекции Fields объекта Record , необходимо задать свойство value , прежде чем можно будет указать другие свойства поля .For new Field objects that have been appended to the Fields collection of a Record object, the Value property must be set before any other Field properties can be specified. Во-первых, конкретное значение свойства value должно быть назначено и Обновлено в коллекции Fields с именем.First, a specific value for the Value property must have been assigned and Update on the Fields collection called. Затем можно получить доступ к другим свойствам, например к типу или атрибутам .Then, other properties such as Type or Attributes can be accessed. Объекты полей следующих типов данных (дататипинум) не могут быть добавлены в коллекцию Fields , и это приведет к ошибке: адаррай, адчаптер, адемпти, адпропварианти адусердефинед.Field objects of the following data types (DataTypeEnum) cannot be appended to the Fields collection and will cause an error to occur: adArray, adChapter, adEmpty, adPropVariant, and adUserDefined. Кроме того, следующие типы данных не поддерживаются ADO: адидиспатч, адиункновни адивариант.Also, the following data types are not supported by ADO: adIDispatch, adIUnknown, and adIVariant. Для этих типов ошибка не будет возникать при добавлении, но использование может привести к непредсказуемым результатам, включая утечки памяти.For these types, no error will occur when appended, but usage can produce unpredictable results including memory leaks.

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

Если не задать свойство CursorLocation перед вызовом метода append , CursorLocation будет иметь значение адусеклиент ( курсорлокатионенум Value) автоматически при вызове метода открытия объекта Recordset .If you do not set the CursorLocation property before calling the Append method, CursorLocation will be set to adUseClient (a CursorLocationEnum value) automatically when the Open method of the Recordset object is called.

Если метод append вызывается для коллекции полей открытого набора записейили для набора записей , где было задано свойство ActiveConnection , возникнет ошибка времени выполнения.A run-time error will occur if the Append method is called on the Fields collection of an open Recordset, or on a Recordset where the ActiveConnection property has been set. Поля можно добавлять только в набор записей , который не является открытым и еще не подключен к источнику данных.You can only append fields to a Recordset that is not open and has not yet been connected to a data source. Обычно это происходит, когда объект набора записей создается с помощью метода CreateRecordset или присваивается объектной переменной.This is typically the case when a Recordset object is fabricated with the CreateRecordset method or assigned to an object variable.

ЗаписейRecord

Ошибка времени выполнения не возникает, если метод append вызывается для коллекции полей открытой записи.A run-time error will not occur if the Append method is called on the Fields collection of an open Record. Новое поле будет добавлено в коллекцию полей объекта Record .The new field will be added to the Fields collection of the Record object. Если запись была получена из набора записей, новое поле не будет отображаться в коллекции полей объекта Recordset .If the Record was derived from a Recordset, the new field will not appear in the Fields collection of the Recordset object.

Несуществующее поле может быть создано и добавлено к коллекции Fields путем присвоения значения объекту поля, как если бы оно уже существовало в коллекции.A non-existent field can be created and appended to the Fields collection by assigning a value to the field object as if it already existed in the collection. Назначение активирует автоматическое создание и добавление объекта поля , после чего назначение будет завершено.The assignment will trigger the automatic creation and appending of the Field object, and then the assignment will be completed.

После добавления поля в коллекцию Fields объекта Record вызовите метод Update коллекции Fields , чтобы сохранить изменения.After appending a Field to the Fields collection of a Record object, call the Update method of the Fields collection to save the change.

ПрименениеApplies To

См. такжеSee Also

Примеры методов Append и CreateParameter (Visual Basic) Append and CreateParameter Methods Example (VB)
Пример методов Append и CreateParameter (Visual c++) Append and CreateParameter Methods Example (VC++)
Метод CreateParameter (ADO) CreateParameter Method (ADO)
Метод Delete (коллекция полей ADO) Delete Method (ADO Fields Collection)
Метод Delete (Коллекция параметров ADO) Delete Method (ADO Parameters Collection)
Метод Delete (набор записей ADO) Delete Method (ADO Recordset)
Метод UpdateUpdate Method