Метод DataRecordsets.AddFromConnectionFile (Visio)

Статья
04/07/2023

Добавляет объект DataRecordset в коллекцию DataRecordsets с помощью сведений о подключении и запросах, содержащихся в файле подключения к данным Office (ODC), для подключения к источнику данных OLEDB или ODBC и их извлечения из нее.

Примечание.

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

Синтаксис

expression. AddFromConnectionFile (FileName, AddOptions, Name)

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

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
FileName	Обязательный	String	Имя используемого файла подключения ODC.
AddOptions	Обязательный	Long	Параметры, определяющие свойства добавляемого набора записей данных. Сочетание одного или нескольких перечисленных значений из VisDataRecordsetAddOptions. Дополнительные сведения см. в разделе "Комментарии".
Name	Необязательно заполнять.	String	Назначает отображаемое имя добавляемого объекта DataRecordset .

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

DataRecordset

Замечания

Для параметра FileName передайте имя и полный путь к ODC-файлу, который содержит строку подключения, указывающую способ подключения к источнику данных OLEDB или ODBC, и строку запроса, указывающую способ извлечения требуемых данных из источника данных.

ODC-файл использует HTML и XML для хранения сведений о подключении и запросах. Содержимое файла можно просмотреть или изменить в любом текстовом редакторе. ODC-файлы имеют расширение ODC-файла. Используйте мастер подключения к данным в Microsoft Access или Microsoft Excel, чтобы создать ODC-файл, который будет подключаться к нужным данным и извлекать их.

Параметр AddOptions может быть сочетанием одного или нескольких из следующих значений перечисления VisDataRecordsetAddOptions , объявленного в библиотеке типов Visio. Значение по умолчанию равно нулю (0), что указывает, что ни один из параметров не задан.

Константа	Значение	Описание
visDataRecordsetNoExternalDataUI	1	Запрещает отображение данных в новом наборе записей данных в окне Внешние данные .
visDataRecordsetNoRefreshUI	2	Запрещает включение набора записей данных в операцию обновления и его отображение в диалоговом окне Обновление данных .
visDataRecordsetNoAdvConfig	4	Запрещает отображение набора записей данных в диалоговом окне Настройка обновления .
visDataRecordsetDelayQuery	8	Добавляет набор записей данных, но не выполняет запрос CommandString до следующего вызова метода Refresh .
visDataRecordsetDontCopyLinks	16	Добавляет набор записей данных, но связи с данными фигуры не вырезаются и не копируются.

После назначения этих значений их нельзя изменить в течение срока жизни объекта DataRecordset .

Аргумент Name — это необязательная строка, которая позволяет назначить набору записей данных отображаемое имя. Если указать, что окно внешних данных отображается в пользовательском интерфейсе Visio, имя, передаваемое для этого аргумента, появится на вкладке окна Внешние данные , соответствующего добавленным набору записей данных.

Если метод AddFromConnectionFile успешно выполнен, он выполняет следующие действия:

Создает объект DataRecordset и присваивает ему имя, указанное в параметре Name. Если не указать имя, Visio присваивает набору записей данных имя таблицы базы данных, которая является источником данных.
Связывает новый или существующий объект DataConnection с объектом DataRecordset .
Выполняет строку запроса, указанную в командной строке в ODC-файле, и извлекает полученные данные.
Сопоставляет типы данных столбцов источника данных с эквивалентными типами данных Visio, фильтруя результаты, чтобы удалить столбцы источника данных, которые не могут быть связаны с фигурами Visio, так как они не имеют эквивалентного типа данных Visio.
Назначает идентификатор строки каждой строке в наборе записей данных. Дополнительные сведения об идентификаторах строк см. в разделе Свойства DataRecordset.GetDataRowIDs .

Примечание.

Метод AddFromConnectionFile завершается ошибкой и возвращает исключение, если возникают ошибки сетевого подключения, время ожидания сети или ошибки разрешений базы данных.

Пример

В следующем макросе Microsoft Visual Basic для приложений (VBA) показано, как можно использовать метод AddFromConnectionString для подключения документа Visio для подключения к данным в таблице Products базы данных Northwind, поставляемой с Microsoft Access. Перед выполнением этого примера кода создайте ODC-файл с помощью мастера подключения к данным и замените значение переменной strFile полным путем к созданному ODC-файлу и его именем. При необходимости укажите другое значение для переменной strName .

Public Sub AddFromConnectionFile_Example() 
 
    Dim strFile As String 
    Dim strName As String 
    Dim vsoDataRecordset As Visio.DataRecordset 
 
    strFile = "C:\Users\username \Documents\My Data Sources\Northwind.mdb Products.odc" 
 
    strName = "Data from ODC" 
 
    Set vsoDataRecordset = ThisDocument.DataRecordsets.AddFromConnectionFile(strFile, 0, strName) 
 
End Sub

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

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

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