DataRecordset.Refresh 方法 (Visio)

执行与连接 (非基于 XML) DataRecordset 关联的查询字符串，并使用查询返回的数据源中的新数据更新链接的形状。

注意

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

语法

expression.Refresh

表达 返回 DataRecordset 对象的表达式。

返回值

Nothing

注解

对特定 DataRecordset 对象调用 Refresh 方法会导致刷新与同一 DataConnection 对象关联的所有其他 DataRecordset 对象 (，即为其 DataConnection 属性) 具有相同的值。 共享相同 DataConnection 属性值的 DataRecordset 对象称为事务处理的数据记录集。 必须在与 DataConnection 对象关联的数据记录集上调用 Refresh 方法。

如果对未与 DataConnection 对象关联的数据记录集（使用 DataRecordsets.AddFromXML 方法创建）调用 Refresh，则 Refresh 方法将返回错误。

如果调用 Refresh 时产生冲突，Visio 将在用户界面中显示“刷新冲突”任务窗格，除非将 DataRecordset.RefreshSettings 属性设置为包括 visRefreshNoReconciliationUI 枚举值。

在刷新链接数据之前，如果要更改 Visio 用于检索数据的查询字符串以查询同一数据库中的其他表，请将 DataRecordset.CommandString 属性设置为新值。 若要连接到全新的数据源，请同时设置 DataRecordset.CommandString 和 DataConnection.ConnectionString 属性值。

刷新数据并发生冲突时，可以使用 DataRecordset.GetAllRefreshConflicts 和 DataRecordset.GetMatchingRowsForRefreshConflict 方法确定冲突的发生原因。

示例

此 Microsoft Visual Basic for Applications (VBA) 宏演示如何使用 Refresh 方法从当前文档的 DataRecordsets 集合中刷新 DataRecordset 对象中的数据。 它获取与当前文档关联的所有数据记录集的计数，并刷新最近添加的数据记录集。 它还会刷新与当前文档关联并与正在刷新的数据记录集共享同一数据连接的其他所有数据记录集。

在运行此宏之前，请确保当前文档至少包含一个数据记录集，并且最近添加的数据记录集已连接（不基于 XML）。

Public Sub Refresh_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intCount As Integer 
 
    intCount = ThisDocument.DataRecordsets.Count 
    Set vsoDataRecordset = ThisDocument.DataRecordsets(intCount) 
    vsoDataRecordset.Refresh 
 
End Sub

支持和反馈

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