Ведущие элементы листа

Статья
02/20/2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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