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


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

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

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

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

  • создание проекта книги Excel;

  • добавление текста в книгу, которая размещена в конструкторе Visual Studio;

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

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

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

    Примечание.

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

Необходимые компоненты

Для выполнения этого пошагового руководства требуются следующие компоненты:

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

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

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

  2. В меню Файл укажите Создать, затем нажмите Проект.

  3. В диалоговом окне "Создание проекта" выберите проект книги VSTO Для Excel.

    Примечание.

    Вы также можете найти шаблоны, введя имя продукта Office в текстовом поле поиска в верхней части диалогового окна "Создание проекта ". Например, при вводе excel отображаются все шаблоны проектов для Excel. Вы также можете отфильтровать список шаблонов, чтобы отобразить только шаблоны для Office, выбрав Office в раскрывающемся списке "Тип проекта". Дополнительные сведения см. в статье "Создание нового проекта в Visual Studio".

  4. Нажмите кнопку Далее.

  5. Введите FirstWorkbookCustomization в поле "Имя" в диалоговом окне "Настройка нового проекта" и нажмите кнопку "Создать".

  6. Выберите "Создать документ" в мастере проектов набор средств Visual Studio для Office и нажмите кнопку "ОК".

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

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

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

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

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

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

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

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

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

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

  1. Закройте книгу, нажав кнопку "Закрыть " (X) для окна конструктора.

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

    - или -

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

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

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

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

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

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

Предупреждение

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

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

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

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

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

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

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

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

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

    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. Закройте книгу.

Очистка проекта

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

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

  1. В Visual Studio в меню Построение выберите пункт Очистить решение.

Следующие шаги

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

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

  • Задачи программирования, относящиеся к настройкам на уровне документа для решений Excel: Excel.

  • Использование объектной модели Excel: обзор объектной модели Excel.

  • Настройка пользовательского интерфейса Excel, например путем добавления настраиваемой вкладки на ленту или создания собственной области действий: настройка пользовательского интерфейса Office.

  • Использование расширенных объектов Excel, предоставляемых средствами разработки Office в Visual Studio для выполнения задач, которые невозможно выполнить с помощью объектной модели Excel (например, размещение управляемых элементов управления в документах и привязке элементов управления Excel к данным с помощью модели привязки данных Windows Forms): автоматизация Excel с помощью расширенных объектов.

  • Создание и отладка настроек уровня документа для Excel: создание решений Office.

  • Развертывание настроек уровня документа для Excel: развертывание решения Office.