WorkbookConnection Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Подключение — это набор сведений, необходимых для получения данных из внешнего источника данных, отличного от 1st_Excel12 книги.
public interface class WorkbookConnection
[System.Runtime.InteropServices.Guid("00024485-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface WorkbookConnection
Public Interface WorkbookConnection
- Атрибуты
Комментарии
Connections можно хранить в книге Excel. При открытии книги Excel создает в памяти копию подключения, которая называется объектом подключения. Объект подключения содержит такие сведения, как имя сервера и имя объекта, открываемого на этом сервере. При необходимости объект подключения может также включать учетные данные проверки подлинности и (или) команду, которая должна быть передана на сервер и выполнена (например, инструкция SELECT, выполняемая SQL Server.)
Примечание. Точная форма подключения зависит от механизма, используемого для получения данных: подключения ODBC, подключения OLEDB и веб-запросы будут содержать разные сведения.
Подключение также может храниться в отдельном файле подключения. Большинство подключений в книге Excel содержат указатель на внешний файл подключения. Файлы подключения имеют расширения, которые четко помечают их как файлы подключения (*. ODC*. IQY и т. д.) и могут находиться на локальном компьютере пользователя или в других хорошо известных или доверенных расположениях, таких как WSS (библиотека подключения к данным) или других корпоративных серверах. Файлы подключений позволяют нескольким пользователям в одной организации повторно использовать подключения. Сетевые администраторы могут изменить способ подключения всей организации к внутреннему источнику данных, изменив один файл подключения. Файл подключения не всегда требуется при подключении к внешнему источнику данных.
Имена подключений — это строки, однозначно определяющие подключения в книге, в которой они используются. Существуют и другие свойства соединения, которые не являются уникальными. Всякий раз, когда формула в Excel принимает аргумент, который является соединением, будет достаточно ссылаться на имя этого соединения напрямую (как строку) или косвенно (путем ссылки на ячейку, содержащую имя соединения в виде строки).
Свойства
_Default |
Подключение — это набор сведений, необходимых для получения данных из внешнего источника данных, отличного от 1st_Excel12 книги. |
Application |
При использовании без квалификатора объектов это свойство возвращает _Application объект, представляющий приложение Microsoft Office Excel. При использовании с квалификатором объектов это свойство возвращает объект Application , представляющий создателя указанного объекта. Только для чтения. |
Creator |
Возвращает 32-битное целое число, указывающее на приложение, в котором объект был создан. Только для чтения, Integer. |
DataFeedConnection |
Возвращает объект DataFeedConnection , содержащий данные и функциональные возможности, необходимые для подключения к веб-каналам данных. Только для чтения |
Description |
Возвращает или задает краткое описание объекта WorkbookConnection . Для чтения и записи, String. |
InModel |
Указывает, был ли добавлен объект WorkbookConnection в модель. Логическое значение (bool in C#) доступно только для чтения. |
ModelConnection |
Возвращает объект, содержащий сведения о новом типе подключения модели, появившемся в Excel 2013, для взаимодействия с интегрированной моделью данных. Только для чтения |
ModelTables |
Возвращает объект, связанный ModelTables с конкретным соединением. Только для чтения |
Name |
Возвращает или задает имя объекта подключения книги. Для чтения и записи, String. |
ODBCConnection |
Повторно настраивает сведения о подключении ODBC для указанного WorkbookConnection объекта. Только для ODBCConnectionчтения . |
OLEDBConnection |
Повторно настраивает сведения о подключении OLEDB для указанного WorkbookConnection объекта. Только для OLEDBConnectionчтения . |
Parent |
Возвращает родительский объект для указанного объекта. Только для чтения. |
Ranges |
Возвращает диапазон объекта для указанного WorkbookConnection объекта. Только для Rangesчтения . |
RefreshWithRefreshAll |
Определяет, следует ли обновить подключение при выполнении обновления всех компонентов. Boolean (bool in C#). Для чтения и записи. |
TextConnection |
TextConnection Возвращает объект , содержащий сведения о запросе к текстовому файлу. Только для чтения. |
Type |
Возвращает тип подключения книги. Только для XlConnectionTypeчтения . |
WorksheetDataConnection |
Возвращает объект, содержащий сведения для подключения из модели PowerPivot к данным в книге, таким как диапазон, именованный диапазон или таблица. Только для чтения. |
Методы
Delete() |
Удаляет подключение к книге. |
Refresh() |
Обновляет подключение к книге. |