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

Создание контентной надстройки Excel

  • Статья

В этой статье описан процесс создания контентной надстройки Excel с помощью Visual Studio.

Предварительные условия

  • Visual Studio 2019 или более поздней версии с установленной рабочей нагрузкой Разработка надстроек для Office и SharePoint.

    Примечание.

    Если вы уже установили Visual Studio, используйте установщик Visual Studio, чтобы убедиться, что также установлена рабочая нагрузка Разработка надстроек для Office и SharePoint.

  • Пакет Office, подключенный к подписке Microsoft 365 (включая Office в Интернете).

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

  1. В Visual Studio выберите пункт Создать проект.

  2. Используя поле поиска, введите надстройка. Выберите вариант Веб-надстройка Excel и нажмите кнопку Далее.

  3. Присвойте проекту имя ExcelWebAddIn1 и выберите Создать.

  4. В диалоговом окне Создание надстройки Office выберите тип надстройки Вставка содержимого в электронные таблицы Excel , а затем нажмите кнопку Далее.

  5. Выберите шаблон надстройки Базовая надстройка или Надстройка визуализации документов , а затем нажмите кнопку Готово , чтобы создать проект.

  6. Visual Studio создаст решение, и два соответствующих проекта появятся в обозревателе решений. В Visual Studio откроется файл Home.html.

Обзор решения Visual Studio

После завершения работы мастера Visual Studio создает решение, которое содержит два проекта.

Project Описание
Проект надстройки Содержит только файл манифеста надстройки в формате XML, который содержит все параметры, описывающие надстройку. Эти параметры помогают приложению Office определить условия активации и место отображения надстройки. Visual Studio создает этот файл автоматически, чтобы вы могли сразу запускать проект и использовать надстройку. Измените эти параметры в любое время, изменив XML-файл.
Проект веб-приложения Содержит страницы контента надстройки, включающие все файлы и ссылки на файлы, необходимые для разработки страниц HTML и JavaScript с поддержкой Office. При разработке надстройки Visual Studio размещает веб-приложение на локальном сервере IIS. Для публикации надстройки этот проект веб-приложения нужно развернуть на веб-сервере.

Обновление манифеста

  1. Откройте Обозреватель решений, перейдите к проекту надстройки ExcelWebAddIn1, затем откройте каталог ExcelWebAddIn1Manifest. Этот каталог содержит ExcelWebAddIn1.xml (ваш файл манифеста). Файл манифеста определяет параметры и возможности надстройки. Дополнительные сведения о двух проектах, созданных решением Visual Studio, приведены ранее в разделе Обзор решения Visual Studio.

  2. Элемент ProviderName содержит заполнитель. Замените его на свое имя.

  3. Атрибут DefaultValue элемента DisplayName содержит заполнитель. Замените его на строку Моя надстройка Office.

  4. Атрибут DefaultValue элемента Description содержит заполнитель. Замените его контентной надстройкой для Excel..

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

    ...
<ProviderName>John Doe</ProviderName>
<DefaultLocale>en-US</DefaultLocale>
<!-- The display name of your add-in. Used on the store and various places of the Office UI such as the add-ins dialog. -->
<DisplayName DefaultValue="My Office Add-in" />
<Description DefaultValue="A content add-in for Excel."/>
...

Проверка

  1. С помощью Visual Studio протестируйте только что созданную надстройку Excel, нажав клавишу F5 или нажав кнопку Пуск , чтобы запустить Excel с контентной надстройкой, отображаемой в электронной таблице.

  2. Убедитесь, что на листе есть текст, а затем выделите любой диапазон ячеек, содержащих текст на листе.

  3. Выберите вкладку для выбранного шаблона, а затем следуйте инструкциям.

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

      Содержимое надстройки, открытое в Excel.

Примечание.

Чтобы увидеть выходные данныеconsole.log, нужен отдельный набор средств разработчика для консоли JavaScript. Дополнительные сведения о средствах F12 и средствах разработчика Microsoft Edge см. в статье Отладка надстроек с помощью средств разработчика для Internet Explorer, Отладка надстроек с помощью средств разработчика для устаревшей версии Microsoft Edge или Отладка надстроек с помощью средств разработчика в Microsoft Edge (на основе Chromium).

Дальнейшие действия

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

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

  • Если надстройка отображает ошибку (например, "Не удалось запустить эту надстройку. Закройте это диалоговое окно, чтобы игнорировать проблему, или нажмите кнопку "Перезапустить", чтобы повторить попытку.") При нажатии клавиши F5 или нажатии кнопки Отладка>Начать отладку в Visual Studio см . раздел Отладка надстроек Office в Visual Studio для других параметров отладки.

Примеры кода

См. также