Append 方法 (ADO)

  • 项目

将对象追加到集合中。 如果集合为 Fields，则可以创建新 Field 对象，然后再追加到该集合。

语法

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

参数

collection
一个集合对象。

字段
一个 Fields 集合。

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

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

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

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

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

FieldValue
可选。 一个 Variant，表示新字段的值。 如果未指定，该字段将附加一个 null 值。

备注

Parameters 集合

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

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

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

Fields 集合

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

注意

对于已追加到 Record 对象的 Fields 集合的新 Field 对象，必须先设置 Value 属性，然后才能指定任何其他 Field 属性。 首先，必须为 Value 属性分配特定值，并在 Fields 集合上调用 Update。 然后，可以访问其他属性，如 Type 或 Attribute。 以下数据类型 (DataTypeEnum) 的 Field 对象无法追加到 Fields 集合，并将导致错误发生：adArray、adChapter、adEmpty、adPropVariant 和 adUserDefined。 此外，ADO 不支持以下数据类型：adIDispatch、adIUnknown 和 adIVariant。 对于这些类型，追加时不会发生任何错误，但使用情况可能会产生不可预知的结果，包括内存泄漏。

记录集

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

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

记录

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

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

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

应用于

另请参阅

Append 和 CreateParameter 方法示例 (VB)
Append 和 CreateParameter 方法示例 (VC++)
CreateParameter 方法 (ADO)
Delete 方法（ADO 字段集合）
Delete 方法（ADO 参数集合）
Delete 方法（ADO 记录集）
Update 方法