Метод DataRecordset.Refresh (Visio)
Выполняет строку запроса, связанную с подключенным (не основанным на 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 и обратная связь.