DoCmd.CopyObject 方法 (Access)
CopyObject 方法在 Visual Basic 中执行 CopyObject 操作。
语法
表达式。CopyObject (DestinationDatabase、 NewName、 SourceObjectType、 SourceObjectName)
expression:表示 DoCmd 对象的变量。
参数
名称 | 必需/可选 | 数据类型 | 说明 |
---|---|---|---|
DestinationDatabase | 可选 | Variant | 一个字符串表达式,该表达式是要将对象复制到的数据库的有效路径和文件名。 若要选择当前数据库,请将此参数留空。 注意:在 Microsoft Access 项目中 (.adp) 中,必须将 DestinationDatabase 参数留空。 如果在库数据库中执行包含 CopyObject 方法的 Visual Basic 代码并将此参数留空,Access 会将对象复制到库数据库中。 |
NewName | 可选 | Variant | 一个字符串表达式,它是要复制的对象的新名称。 若要在复制到另一数据库时使用相同的名称,请将此参数保留为空白。 |
SourceObjectType | 可选 | AcObjectType | 一个 AcObjectType 常量,表示要复制的对象的类型。 |
SourceObjectName | 可选 | Variant | 一个字符串表达式,该表达式是 SourceObjectType 参数选择的类型的对象的有效名称。 如果在库数据库中运行包含 CopyObject 方法的 Visual Basic 代码,则 Access 首先在库数据库中查找具有此名称的对象,然后在当前数据库中查找该对象。 |
备注
使用 CopyObject 操作将指定的数据库对象复制到其他 Access 数据库或同一个数据库或 Access 项目, (.adp) 新名称。 例如,您可以将现有对象复制或备份到另一个数据库中,也可以快速创建略有更改的类似对象。
对于此方法,必须包含 DestinationDatabase 或 NewName 参数或两者。
如果将 SourceObjectType 和 SourceObjectName 参数留空 (SourceObjectType) 假定默认常量 acDefault,Access 将复制在“数据库”窗口中选择的对象。 若要在“数据库”窗口中选择对象,可以使用 SelectObject 操作或 SelectObject 方法,并将 InDatabaseWindow 参数设置为 Yes (True) 。
如果指定 SourceObjectType 和 SourceObjectName 参数,但将 NewName 参数或 DestinationDatabase 参数留空,则必须包含 NewName 或 DestinationDatabase 参数的逗号。 如果将尾随参数留空,请不要在指定的最后一个参数后使用逗号。
示例
以下示例使用 CopyObject 方法复制 Employees 表,并在当前数据库中为其指定新名称。
DoCmd.CopyObject, "Employees Copy", acTable, "Employees"
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。