Метод DataRecordset.Refresh (Visio)

Статья
04/07/2023

Выполняет строку запроса, связанную с подключенным (не основанным на XML) DataRecordset , и обновляет связанные фигуры новыми данными из источника данных, возвращаемого запросом.

Примечание.

Этот объект или элемент Visio доступен только лицензированным пользователям Visio профессиональный 2013.

Синтаксис

выражение.Refresh

Выражение Выражение, возвращающее объект DataRecordset .

Возвращаемое значение

Отсутствует

Примечания

Вызов метода Refresh для определенного объекта DataRecordset приводит к обновлению всех остальных объектов DataRecordset , связанных с тем же объектом DataConnection (то есть с тем же значением для свойства DataConnection ). Объекты DataRecordset, использующие одно и то же значение свойства DataConnection, называются наборами записей данных с транзакцией. Метод Refresh должен вызываться для набора записей данных, связанного с объектом DataConnection .

При вызове Refresh для набора записей данных, не связанного с объектом DataConnection (который был создан с помощью метода DataRecordsets.AddFromXML ), метод Refresh вернет ошибку.

Если вызов Refresh приводит к конфликтам, Visio отображает область задач "Конфликты обновления " в пользовательском интерфейсе, если свойство DataRecordset.RefreshSettings не включает перечисленное значение visRefreshNoReconciliationUI .

Если перед обновлением связанных данных необходимо изменить строку запроса, которую Visio использует для получения данных для запроса другой таблицы в той же базе данных, задайте для свойства DataRecordset.CommandString новое значение. Чтобы подключиться к совершенно новому источнику данных, задайте значения свойств DataRecordset.CommandString и DataConnection.ConnectionString .

При обновлении данных и возникновении конфликта можно использовать методы DataRecordset.GetAllRefreshConflicts и DataRecordset.GetMatchingRowsForRefreshConflict , чтобы определить причину возникновения конфликта.

Пример

В этом макросе Microsoft Visual Basic для приложений (VBA) показано, как использовать метод Refresh для обновления данных в объекте DataRecordset из коллекции DataRecordsets текущего документа. Он получает количество всех наборов данных, связанных с текущим документом, и обновляет последний добавленный. Он также обновляет все другие наборы записей данных, связанные с текущим документом, которые совместно используют общее подключение к данным с обновляемым.

Перед выполнением этого макроса убедитесь, что текущий документ содержит по крайней мере один набор записей данных, а последний добавленный набор данных подключен (не на основе 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 и обратная связь.

Поделиться через