Share via

Элемент узла книги

  • Статья

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

Область применения. Сведения в этом разделе относятся к проектам уровня документа и проектам надстроек VSTO для Excel. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

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

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

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

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

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

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

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

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

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

Примечание.

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

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

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

Связанный контент