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

Пошаговое руководство. Создание первой настройки уровня документа для Excel

  • Статья

Во вводном разделе пошагового руководства показано, как создавать настройку уровня документа для Microsoft Office Excel.Функциональные возможности, создаваемые в этом виде решения, доступны только, когда открыта конкретная рабочая книга.Невозможно воспользоваться настройками уровня документа для выполнения изменений на уровне приложения, например, для отображения новой вкладки ленты, когда открыта рабочая книга.

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

В данном пошаговом руководстве рассмотрены следующие задачи:

  • Создание проекта книги Excel.

  • Добавление текста к листу, размещенному в конструкторе Visual Studio.

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

  • Построение и запуск проекта для тестирования.

  • Очистка завершенного проекта с целью удаления ненужных файлов построения и параметров безопасности из компьютера разработчика.

ПримечаниеПримечание

На вашем компьютере названия некоторых элементов интерфейса пользователя Visual Studio или их расположение могут отличаться от указанных в нижеследующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Параметры Visual Studio.

Обязательные компоненты

Ниже приведены компоненты, необходимые для выполнения данного пошагового руководства.

-

Выпуск Visual Studio 2012, включающий инструменты разработчика Microsoft Office. Дополнительные сведения см. в разделе [Настройка компьютера для разработки решений Office](bb398242\(v=vs.110\).md).
  • Excel 2013 или Excel 2010.

Создание проекта

Создание нового проекта рабочей книги Excel в Visual Studio

  1. Запустите Visual Studio.

  2. В меню Файл последовательно выберите пункты Создать и Проект.

  3. В области шаблонов разверните узел Visual C# или Visual Basic, а затем разверните Office/SharePoint.

  4. В разделе развернуть узел Office/SharePoint выберите узел Добавить- ins office.

  5. В списке шаблонов проектов выберите проект Книга Excel 2010 или Книга Excel 2013.

  6. В поле Имя введите FirstWorkbookCustomization.

  7. Нажмите кнопку ОК.

    Откроется вкладка Мастер проектов Visual Studio Tools for Office.

  8. Выберите Создать новый документ и нажмите кнопку OK.

    • Visual Studio создает проект FirstWorkbookCustomization и добавляет в него следующие файлы.

    • FirstWorkbookCustomization.xlsx представляет книгу Excel в проекте.В нем содержатся все листы и диаграммы.

    • Sheet1 (VB-файл для Visual Basic или CS-файл для Visual C#) — книга, предоставляющая рабочую область конструирования и код для первого листа в книге.Дополнительные сведения см. в разделе Ведущие элементы листа.

    • Sheet2 (VB-файл для Visual Basic или CS-файл для Visual C#) — книга, предоставляющая рабочую область конструирования и код для второго листа в книге.

    • Sheet3 (VB-файл для Visual Basic или CS-файл для Visual C#) — книга, предоставляющая рабочую область конструирования и код для третьего листа в книге.

    • ThisWorkbook (VB-файл для Visual Basic или CS-файл для Visual C#) содержит рабочую область конструирования и код для настроек на уровне книги.Дополнительные сведения см. в разделе Ведущий элемент книги.

    Файл кода Sheet1 открывается в конструкторе автоматически.

Закрытие и повторное открытие листов в конструкторе

Если книга или лист намеренно или случайно закрываются во время разработки проекта, их можно открыть повторно.

Закрытие и повторное открытие листа в конструкторе

  1. Для закрытия книги нажмите кнопку Закрыть (X) в окне конструктора.

  2. В Обозревателе решений щелкните правой кнопкой мыши файл кода Sheet1 и выберите пункт Конструктор представлений.

    - или -

    Дважды щелкните файл кода Sheet1 в Обозревателе решений.

Добавление текста на рабочий лист в конструкторе

Можно разработать пользовательский интерфейс настройки, изменив рабочий лист, открытый в конструкторе.Например, можно добавить текст в ячейки, применить формулы или добавить элементы управления Excel.Дополнительные сведения об использовании конструктора см. в разделе Проекты Office в среде Visual Studio.

Добавление текста на лист с помощью конструктора

  • В открытом в конструкторе рабочем листе выберите ячейку A1 и введите следующий текст.

    Этот текст добавлен с помощью конструктора.

Предупреждающее замечаниеВнимание

При добавлении этой строки текста в ячейку A2, она будет переписана другим кодом в этом примере.

Добавление текста на рабочий лист программно

Добавьте следующий код в файл кода Sheet1.Этот новый код использует объектную модель Excel для добавления второй строки текста к книге.По умолчанию файл кода Sheet1 содержит следующий созданный код:

  • Частичное определение класса Sheet1, представляющего модуль программирования рабочего листа и предоставляющего доступ к модели объекта Excel.Дополнительные сведения см. в разделах Ведущие элементы листа и Общие сведения об объектной модели Word.Остальная часть класса Sheet1 определена в скрытом файле кода, который не подлежит изменению.

  • Обработчики событий Sheet1_Startup и Sheet1_Shutdown.Эти обработчики событий вызываются, когда Excel загружает и выгружает настройку.Эти обработчики событий следует использовать для инициализации настройки при ее загрузке и для освобождения ресурсов, занятых настройкой, при ее выгрузке.Дополнительные сведения см. в разделе События в проектах Office.

Добавление второй строки текста на рабочий лист с использованием кода

  1. Правой кнопкой мыши щелкните Sheet1 в Обозревателе решений, а затем нажмите Просмотреть код.

    Файл кода открывается в Visual Studio.

  2. Замените обработчик событий Sheet1_Startup следующим кодом.Когда Sheet1 открыт, этот код добавляет на лист вторую строку текста.

    Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
    nr.Value2 = "This text was added by using code"
End Sub

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Проверка проекта

Проверка рабочей книги

  1. Нажмите клавишу F5 для построения и выполнения проекта.

    При построении проекта код компилируется в сборку, которая связывается с рабочей книгой.Visual Studio помещает копию рабочей книги и сборку в выходную папку построения для проекта и настраивает параметры безопасности на компьютере разработчика так, чтобы обеспечить выполнение настройки.Дополнительные сведения см. в разделе Построение решений Office.

  2. Проверьте в рабочей книге, виден ли следующий текст.

    Этот текст добавлен с помощью конструктора.

    Этот текст добавлен с помощью кода.

  3. Закройте книгу.

Удаление проекта

После завершения разработки проекта следует удалить файлы из выходной папки сборки и созданные процессом сборки параметры безопасности.

Очистка завершенного проекта на компьютере разработчика

  • В меню Visual Studio Построение выберите пункт Удалить решение.

Следующие действия

Теперь, после создания простой настройки уровня приложения для Excel, можно начать более подробное изучение процесса разработки настроек в следующих разделах:

См. также

Основные понятия

Общие сведения о разработке решений Office

Автоматизация Excel с помощью расширенных объектов

Другие ресурсы

Решения Excel

Настройки программирования уровня документа

Общие сведения об объектной модели Excel

Настройка пользовательского интерфейса Office

Построение решений Office

Развертывание решения Office

Общие сведения о шаблонах проектов Office