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

Объект DataRecordset (Visio)

  • Статья

Хранит, форматирует, обновляет и предоставляет данные, запрашиваемые из базы данных в Microsoft Visio.

Примечание.

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

Замечания

Microsoft Visio может подключаться к данным из различных источников, включая следующие:

  • Листы Excel
  • Базы данных Access
  • базы данных SQL Server;
  • Списки SharePoint
  • Другие источники данных OLEDB/ODBC, такие как базы данных Oracle
  • XML-файлы, которые соответствуют классической xml-схеме ADO

Каждый объект Документа Visio имеет коллекцию DataRecordsets , которая пуста до тех пор, пока не будет установлено подключение к источнику данных. Чтобы подключить документ Visio к источнику данных, нужно добавить объект DataRecordset в коллекцию DataRecordsets документа.

Чтобы добавить объект DataRecordset в коллекцию DataRecordsets , можно использовать один из следующих трех методов в зависимости от типа источника данных, к которому требуется подключиться (OLEDB,ODBC или XML), и способа передачи строки подключения и строк команд запроса в Visio. С помощью:

  • Метод DataRecordsets.Add позволяет подключиться к источнику данных OLEDB или ODBC и передать сведения о подключении и запросе сведений о командной строке в Visio непосредственно в качестве параметров метода.

  • Метод DataRecordsets.AddFromConnectionFile — можно подключиться к источнику данных OLEBD или ODBC, передав метод ODC-файл подключения к данным Office (ODC), содержащий сведения о подключении и командной строке запроса, которые необходимо предоставить в Visio.

  • Метод DataRecordsets.AddFromXML передает метод классической XML-строке ADO, содержащей все данные, которые необходимо включить в набор записей данных.

После создания набора записей данных строка подключения и строка команды запроса, связанные с набором записей данных, будут представлены свойствами DataConnection.ConnectionString и CommandString соответственно.

Если набор записей данных связан с объектом DataConnection , т. е. если вы добавили его в коллекцию DataRecordsets с помощью метода Add или AddFromConnectionFile , можно использовать свойство DataConnection , чтобы получить связанный объект DataConnection .

Свойство по умолчанию объекта DataRecordset — ID. Значение свойства ID идентифицирует DataRecordset в коллекции DataRecordsets и является уникальным в коллекции для любого документа.

Используйте свойство Name , чтобы связать отображаемое имя с набором записей данных.

Используйте метод GetDataRowIDs , чтобы получить массив идентификаторов всех строк в наборе записей данных, где каждая строка представляет одну запись данных. После получения идентификаторов строк данных таким образом можно использовать метод GetRowData для получения всех данных, хранящихся в каждом столбце в строке данных.

Используйте свойство DataColumns , чтобы получить объект DataColumn , связанный с набором записей данных. Объект DataColumn предоставляет методы и свойства, которые можно использовать для настройки сопоставления столбцов данных с ячейками в разделе Данные фигуры таблицы фигур Visio для фигур, связанных с данными.

Установка первичного ключевого столбца для набора записей данных может помочь предотвратить неработающие связи между фигурами и данными при обновлении данных. Получить и задать столбец первичного ключа можно с помощью методов GetPrimaryKey и SetPrimaryKey соответственно.

При изменении данных в источнике данных можно обновить данные в подключенном (не XML) наборе данных, чтобы отразить эти изменения. Вы можете указать, что Visio обновляет данные автоматически с заданным интервалом, задав свойство RefreshInterval , или обновить данные программным способом, вызвав метод Refresh .

При обновлении данных из источника данных, который изменился с момента последнего обновления данных, могут возникать конфликты. Конфликты могут возникать, если одна фигура связана с несколькими строками в одном источнике данных или если фигура связана со строкой в источнике данных, который был удален. Вы можете обнаруживать и устранять конфликты, возникающие при обновлении данных, с помощью методов GetAllRefreshConflicts, GetMatchingRowsForRefreshConflict и RemoveRefreshConflict .

Примечание.

При сохранении документа Visio, содержащего один или несколько наборов записей данных, все данные в наборе записей сохраняются в файле Visio. Для наборов записей, содержащих большой объем данных, это может создавать большие файлы Visio, что может повлиять на производительность. Следовательно, перед импортом в Visio следует рассмотреть возможность фильтрации больших источников данных.

События

Методы

Свойства

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.