Ведущий элемент книги

Статья
02/20/2013

Ведущий элемент Workbook является типом, который расширяет тип Microsoft.Office.Interop.Excel.Workbook из основной сборки взаимодействия для Excel.Ведущий элемент Workbook предоставляет те же свойства, методы и события, что и объект Microsoft.Office.Interop.Excel.Workbook, однако имеет ряд дополнительных возможностей.

Применение. Сведения этого раздела применяются к проектам уровня документа и уровня приложения для Excel 2013 и Excel 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

В проектах уровня документа существует ведущий элемент Workbook, который представляет книгу в проекте.В проектах уровня приложения можно создавать ведущие элементы Workbook во время выполнения.

Основные сведения о ведущих элементах книги в проектах уровня документа

Для обращения к книге в проекте используется класс ThisWorkbook.Класс ThisWorkbook обеспечивает доступ к членам класса ведущего элемента Workbook и предназначен для выполнения основных задач по настройке, например для запуска кода при открытии или закрытии книги.Дополнительные сведения см. в разделе Настройки программирования уровня документа.

Класс ThisWorkbook предоставляет местоположение, в котором можно начать написание кода в проекте.Поскольку этот класс содержит те же свойства, методы и события, что и объект Microsoft.Office.Interop.Excel.Workbook в основной сборке взаимодействия для Excel, класс ThisWorkbook можно использовать для обращения к объектной модели приложения Excel.Дополнительные сведения см. в разделе Общие сведения об объектной модели Excel.

Дважды щелкнув элемент проекта ThisWorkbook в обозревателе решений, можно открыть конструктор книг и отобразить свойства и события рабочей книги в окне Свойства.

Ограничения ведущих элементов книг в проектах уровня документа

Проект уровня документа может содержать только один ведущий элемент Workbook (класс ThisWorkbook).Во время разработки не допускается добавление новых ведущих элементов класса Workbook в проект. Также не допускается создание новых ведущих элементов класса Workbook во время выполнения из настройки уровня документа.

При создании новой книги Excel во время выполнения ему присваивается тип Microsoft.Office.Interop.Excel.Workbook.Поскольку такой документ не является ведущим элементом, он не может содержать элементы управления ведущего приложения или Windows Forms.Дополнительные сведения о создании книг во время выполнения см. в разделе Практическое руководство. Программное создание книг Excel.

Ведущий элемент Workbook не функционирует в качестве контейнера для элементов управления ведущего приложения.Таким образом, нельзя добавлять на лист любые видимые элементы управления, но можно добавлять компоненты, такие как DataSet, поскольку эти компоненты могут совместно использоваться всеми листами.В проекте уровня документа компоненты, доступные для рабочей книги, находятся на вкладках панели элементовКомпоненты, Данные и Все формы Windows Forms.

Примечание
Средства разработки Office в Visual Studio не поддерживают общие книги.

Основные сведения о ведущих элементах книги в проектах уровня приложения

В проектах уровня приложения можно создавать ведущий элемент Workbook во время выполнения для любой книги, открытой в Excel.Чтобы создать ведущий элемент Workbook, используйте метод GetVstoObject.Дополнительные сведения см. в разделе Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.