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

Примеры кода надстроек Office

  • Статья

Эти примеры кода помогают узнать, как использовать различные возможности при разработке надстроек Office.

Начало работы

В следующих примерах показано, как создать простейшую надстройку Office, содержащую только манифест, веб-страницу HTML и логотип. Эти компоненты являются основными частями надстройки Office. Дополнительные сведения о том, как начать работу, см. в наших кратких руководствах и учебниках.

Blazor WebAssembly

Если вы разрабатываете надстройки VSTO, в следующих примерах показано, как создавать веб-надстройки Office с помощью .NET Blazor WebAssembly. Большую часть кода можно хранить в C# и Visual Studio.

Excel

Имя Описание
Обозреватель типов данных (предварительная версия) Создает надстройку Excel, которая позволяет создавать и просматривать типы данных в книгах. Типы данных позволяют разработчикам надстроек упорядочивать сложные структуры данных в виде объектов, таких как форматированные числовые значения, веб-изображения и значения сущностей.
Открытие в Teams Создайте новую электронную таблицу Excel в Microsoft Teams, содержащую определенные вами данные.
Вставка внешнего файла Excel и его заполнение данными JSON Вставьте существующий шаблон из внешнего файла Excel в открытую книгу Excel. Затем заполните шаблон данными веб-службы JSON.
Создание настраиваемых контекстных вкладок на ленте Создайте настраиваемую контекстную вкладку на ленте в пользовательском интерфейсе Office. В примере создается таблица: если пользователь перемещает фокус внутри нее, отображается настраиваемая вкладка. Если пользователь перемещается за ее пределы, настраиваемая вкладка будет скрыта.
Пример пользовательской функции, использующей рабочий веб-процесс Используйте рабочие веб-процессы в пользовательских функциях, чтобы предотвратить блокировку пользовательского интерфейса надстройки Office.
Использование методов хранения для доступа к данным из надстройки Office в автономном режиме Реализуйте localStorage, чтобы включить ограниченную функциональность для надстройки Office, если соединение прервано.
Шаблон пакетной обработки пользовательских функций Объедините несколько вызовов в один, чтобы уменьшить количество сетевых вызовов к удаленной службе.

Outlook

Имя Описание
Сообщить о спаме или фишинговых сообщениях в Outlook Создайте интегрированное решение для создания отчетов о нежелательной почте, которое можно легко обнаружить на ленте клиента Outlook. Решение предоставляет пользователю диалоговое окно для отправки сообщения электронной почты. Он также сохраняет копию сообщения электронной почты в файл для дальнейшей обработки в серверной системе.
Шифрование вложений, обработка участников приглашения на собрание и реагирование на изменение даты и времени встречи с помощью активации на основе событий Outlook Используйте активацию на основе событий для шифрования вложений, добавленных пользователем. Также используйте обработку событий для получателей, измененных в приглашении на собрание, и изменений даты и времени начала и окончания в приглашении на собрание.
Определение и добавление тегов внешних получателей с помощью активации на основе событий Outlook Используйте активацию на основе событий для запуска надстройки Outlook при изменении получателей в процессе создания сообщения. Надстройка также использует API appendOnSendAsync для добавления заявления об отказе.
Настройка подписи с помощью активации на основе событий Outlook Используйте активацию на основе событий для запуска надстройки Outlook при создании нового сообщения или встречи. Надстройка может реагировать на события, даже если область задач не открыта. Она также использует API setSignatureAsync.
Проверка цветовых категорий сообщения или встречи перед отправкой с помощью смарт-оповещений Используйте интеллектуальные оповещения Outlook, чтобы убедиться, что требуемые цветовые категории применяются к новому сообщению или встрече перед его отправкой.
Проверка метки конфиденциальности сообщения Используйте API меток конфиденциальности в надстройке на основе событий для проверки и применения метки конфиденциальности к применимым исходящим сообщениям.

Word

Имя Описание
Получение, редактирование и настройка OOXML-содержимого в документе Word с помощью надстройки Word В этом примере показано, как получать, редактировать и настраивать OOXML-содержимое в документе Word. Пример надстройки предоставляет электронный блокнот для получения собственного контента в формате Office Open XML, а также тестирования собственных фрагментов Office Open XML.
Импорт шаблона документа Word с помощью надстройки Word Показано, как импортировать шаблоны в документ Word.
Загрузка и запись содержимого в формате Open XML в надстройке Word В этом примере надстройки показано, как добавлять форматированное содержимое различных типов в документ Word с помощью метода setSelectedDataAsync с типом приведения ooxml. С помощью этой надстройки также можно показывать разметку Office Open XML для каждого типа контента в примере прямо на странице.
Управление цитатами с помощью надстройки Word Показывает, как управлять цитатами в документе Word.

Проверка подлинности, авторизация и единый вход

Имя Описание
Надстройка Office с единым входом с использованием проверки подлинности вложенного приложения Показано, как использовать MSAL.js проверку подлинности вложенного приложения (NAA) в надстройке Office для доступа к API Microsoft Graph для вошедшего пользователя. В примере отображаются имя и адрес электронной почты пользователя, выполнившего вход. Кроме того, в документ вставляются имена файлов из учетной записи Microsoft OneDrive пользователя.
Надстройка Outlook с единым входом с использованием проверки подлинности вложенных приложений Показано, как использовать MSAL.js проверку подлинности вложенного приложения (NAA) в надстройке Outlook для доступа к API Microsoft Graph для вошедшего пользователя. В примере отображаются имя и адрес электронной почты пользователя, выполнившего вход. Он также вставляет имена файлов из учетной записи Microsoft OneDrive пользователя в новый текст сообщения.
Использование единого входа с активацией на основе событий в надстройке Outlook Показано, как использовать единый вход для доступа к данным Microsoft Graph пользователя из события, запущенного в надстройке Outlook.
Пример надстройки Outlook с единым входом Используйте функцию единого входа в Office, чтобы предоставить надстройке доступ к данным Microsoft Graph.
Получение данных OneDrive с помощью Microsoft Graph и msal.js в надстройке Office Создайте надстройку Office как одностраничное приложение без серверной части, которое подключается к Microsoft Graph, и получите доступ к книгам, хранящимся в OneDrive для бизнеса, чтобы обновить электронную таблицу.
Проверка подлинности надстройки Office для Microsoft Graph Узнайте, как создать надстройку Microsoft Office, которая подключается к Microsoft Graph, и получить доступ к книгам, хранящимся в OneDrive для бизнеса, чтобы обновить электронную таблицу.
Проверка подлинности надстройки Outlook для Microsoft Graph Создайте надстройку Outlook, которая подключается к Microsoft Graph, и получите доступ к книгам, хранящимся в OneDrive для бизнеса, чтобы создать новое сообщение электронной почты.
Надстройка Office с единым входом на ASP.NET Используйте API getAccessToken в Office.js, чтобы предоставить надстройке доступ к данным Microsoft Graph. Этот пример построен на ASP.NET.
Надстройка Office с единым входом на Node.js Используйте API getAccessToken в Office.js, чтобы предоставить надстройке доступ к данным Microsoft Graph. Этот пример построен на Node.js.

Office

Имя Описание
Сохранение пользовательских параметров в надстройке Office Сохранение пользовательских параметров в надстройке Office. Надстройка хранит данные в виде пар "ключ-значение" с помощью пакета свойств API JavaScript для Office, файлов cookie браузера, веб-хранилища (localStorage и sessionStorage) или путем хранения данных в скрытом div в документе.
Использование сочетаний клавиш для действий надстройки Office Создавайте настраиваемые сочетания клавиш для вызова определенных действий для надстройки Office.

Общее время выполнения

Имя Описание
Совместный доступ к глобальным данным с общей средой выполнения Настройте базовый проект, в котором используется общая среда выполнения, для запуска кода для кнопок ленты, области задач и пользовательских функций в единой среде выполнения браузера.
Управление лентой и пользовательским интерфейсом области задач и запуск кода при открытии документа Создайте контекстные кнопки ленты, которые включаются в зависимости от состояния вашей надстройки.

Дополнительные примеры

Имя Описание
Использование общей библиотеки для переноса надстройки набора средств Visual Studio для Office в веб-надстройку Office Предоставляет стратегию повторного использования кода при переходе с надстроек VSTO на надстройки Office.
Интеграция функции Azure с пользовательской функцией Excel Интегрируйте функции Azure с пользовательскими функциями для перемещения в облако или интегрируйте дополнительные службы.
Примеры динамического кода DPI Коллекция примеров для обработки изменений DPI в надстройках COM, VSTO и Office.

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

Присоединяйтесь к программе разработчиков Microsoft 365 , чтобы получить ресурсы и сведения, которые помогут вам создавать решения для платформы Microsoft 365, включая рекомендации, адаптированные к интересующим вас областям.

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