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

Элемент узла листа

  • Статья

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

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

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

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

При создании проекта уровня документа для Excel Visual Studio автоматически создает три ведущих элемента Worksheet в проекте. По умолчанию эти листы получают имена Sheet1, Sheet2и Sheet3. При создании проекта на основе существующей книги количество ведущих элементов зависит от числа листов в этой книге.

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

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

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

Переименование листов

В проекте уровня документа можно переименовывать листы в конструкторе Visual Studio, но при этом меняется только отображаемое имя листа. Программным именем остается имя листа по умолчанию. При переименовании листа в окне Свойства изменяется только программное имя.

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

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

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

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

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

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