DataRecordset.Name 属性 (Visio)

获取或设置数据记录集的显示名称。 读/写。

注意

此 Visio 对象或成员仅供 Visio Professional 2013 的授权用户使用。

语法

表达式名字

表达 一个代表 DataRecordset 对象的变量。

返回值

String

备注

DataRecordset 对象的显示名称是首次创建数据记录集时作为 Name 参数传递给 DataRecordsets.AddDataRecordsets.AddFromConnectionFileDataRecordsets.AddFromXML 方法的名称;或随后通过设置此属性分配的名称。 如果在创建数据记录集时未分配名称,则 Microsoft Visio 会分配默认名称,例如 Sheet1 ,如果从 Microsoft Excel 工作簿导入数据,该名称将是分配的名称。

如果(在一种 Add 方法的 AddOptions 参数中)指定应在 Visio 用户界面中显示“外部数据”窗口,则显示名称会出现在“外部数据”窗口中数据记录集的对应选项卡上。

Name 属性值在特定的文档中必须是唯一的,即不能将同一显示名称分配给多个数据记录集。 如果试图将现有数据记录集的 Name 属性值分配给同一文档中的其他数据记录集,则分配操作将失败。 如果使用 Add 方法向文档添加一个新的数据记录集,并且将现有数据记录集的名称作为显示名称传递给 Add 方法,则 Visio 会向该名称附加一个短划线和数字(如 -1),以使其成为文档上下文中的唯一名称。

但如果删除了某一数据记录集,则可以对同一文档中的其他数据记录集重用此已删除数据记录集的显示名称。 这与 DataRecordset.ID 属性值的情况相反。 特定 ID 在文档的生命周期中是唯一的,即使删除了分配给该 ID 的数据记录集,也无法重复使用它。

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。