Append 方法 （ADO）

将对象追加到集合中。 如果集合是 Fields，则可以在将新的 Field 对象追加到集合之前创建。

语法

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

参数

集合
集合对象。

领域
Fields 集合。

对象
一个对象变量，表示要追加的对象。

名称
一个字符串值，该值包含新 Field 对象的名称，并且不能与字段中的任何其他对象相同。

类型
一个 DataTypeEnum 值，其默认值为 adEmpty，指定新字段的数据类型。 ADO 不支持以下数据类型，在将新字段追加到 Recordset 对象（ADO）时不应使用： adIDispatch、 adIUnknown、 adVariant。

DefinedSize
可选。 一个 Long 值，表示新字段的定义大小（以字符或字节为单位）。 此参数的默认值派生自 Type。 DefinedSize 大于 255 字节的字段被视为可变长度列。 未指定 DefinedSize 的默认值。

Attrib
可选。 一个 FieldAttributeEnum 值，其默认值为 adFldDefault，指定新字段的属性。 如果未指定此值，字段将包含派生自 Type 的属性。

FieldValue
可选。 一个 Variant 类型的值，表示新字段的值。 如果未指定，则字段将追加一个 null 值。

注解

Parameters 集合

在将其追加到 Parameters 集合之前，必须设置 Parameter 对象的 Type 属性。 如果选择可变长度数据类型，则还必须将 Size 属性设置为大于零的值。

自行描述参数可最大程度地减少对提供程序的调用，因此在使用存储过程或参数化查询时可提高性能。 但是，必须知道与要调用的存储过程或参数化查询关联的参数的属性。

使用 CreateParameter 方法可以使用适当的属性设置创建 参数 对象，并使用 Append 方法将它们添加到 Parameters 集合。 这使你可以设置和返回参数值，而无需调用提供程序以获取参数信息。 如果要写入不提供参数信息的提供程序，则必须使用此方法手动填充 Parameters 集合，以便使用参数。

Fields 集合

仅当将 Field 对象添加到 Record 对象而不是 Recordset 对象时，FieldValue 参数才有效。 使用 Record 对象，可以追加字段并同时提供值。 使用 Recordset 对象时，必须在 记录集 关闭时创建字段，然后打开 Recordset 并将值分配给字段。

记录集

如果在调用 Append 方法之前未设置 CursorLocation 属性，则调用 Recordset 对象的 Open 方法时，CursorLocation 将自动设置为 adUseClient （CursorLocationEnum 值）。

如果在打开的 Recordset 的 Fields 集合或已设置 ActiveConnection 属性的 Recordset 上调用 Append 方法，则会出现运行时错误。 只能将字段追加到尚未打开且尚未连接到数据源的 Recordset 。 这通常是使用 CreateRecordset 方法捏造 Recordset 对象或分配给对象变量的情况。

记录

如果在打开的 Record 的 Fields 集合上调用 Append 方法，则不会发生运行时错误。 新字段将添加到 Record 对象的 Fields 集合中。 如果记录派生自 Recordset，则新字段将不会显示在 Recordset 对象的 Fields 集合中。

通过将值分配给字段对象，可以创建和追加到 Fields 集合中不存在的字段，就好像它已存在于集合中一样。 分配将触发 Field 对象的自动创建和追加，然后完成分配。

将字段追加到 Record 对象的 Fields 集合后，调用 Fields 集合的 Update 方法以保存更改。

应用到

• Fields 集合 （ADO）
• Parameters 集合 （ADO）

另请参阅

Append 和 CreateParameter 方法示例 （VB）
Append 和 CreateParameter 方法示例 （VC++）
CreateParameter 方法 （ADO）
Delete 方法（ADO Fields 集合）
Delete 方法（ADO 参数集合）
Delete 方法 （ADO Recordset）
Update 方法