Office アドインのコード サンプル

これらのコード サンプルは、Office アドインを開発する場合のさまざまな機能の使用方法を学ぶサポートのために書かれています。

はじめに

次のサンプルは、マニフェスト、HTML Web ページ、ロゴのみを使用して最も単純な Office アドインを構築する方法を示しています。 これらのコンポーネントは、Office アドインの基本的な部分です。 その他の開始情報については、クイック スタートとチュートリアルを参照してください。

作業ウィンドウ アドイン

コンテンツ アドイン

完了したチュートリアル

名前 説明
Excel チュートリアル このサンプルは、作業ウィンドウとコマンド リボン ボタンを使用して Excel アドインを作成 する方法を示す「チュートリアル: Excel 作業ウィンドウ アドインを作成する」の完成版です。 アドインは、テーブルの作成と並べ替え、グラフの作成、行の固定、ワークシートの保護、ダイアログ ボックスの表示方法を示しています。
Outlook チュートリアル このサンプルは、「 チュートリアル: メッセージ作成の Outlook アドインを作成 する」の完成版で、メッセージ作成画面の Outlook アドインをビルドする方法を示しています。 アドインは、ユーザーから情報を収集し、外部サービスからデータをフェッチし、関数コマンドを実装し、作業ウィンドウを実装し、メッセージの本文にコンテンツを挿入し、ダイアログ ボックスを表示する方法を示します。
PowerPoint チュートリアル (yo office) このサンプルは、 作業ウィンドウを使用してPowerPoint アドインを作成 する方法を示す、チュートリアル: PowerPoint作業ウィンドウ アドインを作成する完了したバージョンです。 アドインは、スライドに画像を追加する方法、スライドにテキストを追加する方法、スライドメタデータを取得する方法、スライド間を移動する方法を示しています。
PowerPoint チュートリアル (Visual Studio) このサンプルは、 作業ウィンドウを使用してPowerPoint アドインを作成 する方法を示す、チュートリアル: PowerPoint作業ウィンドウ アドインを作成する完了したバージョンです。 アドインでは、その日のBing写真をスライドに追加する方法、スライドにテキストを追加する方法、スライド メタデータを取得する方法、スライド間を移動する方法を示します。
Word チュートリアル このサンプルは、作業ウィンドウを使用してWord アドインを作成する方法を示す、チュートリアル: Word作業ウィンドウ アドインを作成する完了したバージョンです。 アドインは、テキスト範囲、段落、画像、HTML、テーブル、コンテンツ コントロールを挿入および置換する方法を示しています。
Office アドインの初回実行エクスペリエンス チュートリアル このサンプルは、初回実行エクスペリエンス (FRE) の実装の 基本を示す基本的な初回実行エクスペリエンスを備えた Office アドインのビルド の完成版です。 このサンプルでは Excel を使用しますが、このパターンは、Office Web アドインがサポートされている他の Office アプリケーションに適用できます。

Blazor WebAssembly

開発の背景が VSTO アドインのビルドにある場合、次のサンプルは、.NET Blazor WebAssembly を使用して Office Web アドインをビルドする方法を示しています。 コードの多くは C# と Visual Studio に保持できます。

Excel

名前 説明
自動開く作業ウィンドウを使用して Web サイトから Excel ブックを作成する Node.js を使用して Web サイト データから Excel ブックを作成し、ドキュメントを開いたときにカスタム Office アドイン作業ウィンドウが自動的に開くように構成します。
データ型エクスプローラー ブック内のデータ型を作成して調べる。 データ型を使用すると、アドイン開発者は、書式設定された数値、Web イメージ、エンティティ値など、複雑なデータ構造をオブジェクトとして整理できます。
Teams で開く Microsoft Teams で、定義したデータを含む新しい Excel スプレッドシートを作成します。
外部の Excel ファイルを挿入し、JSON データで設定する 現在開いている Excel ブックに、外部の Excel ファイルの既存のテンプレートを挿入します。 次に、JSON Web サービスのデータをテンプレートに設定します。
リボンのカスタム コンテキスト タブを作成する Office UI のリボンでカスタム コンテクスト タブを作成します。 このサンプルでは、テーブルを作成し、ユーザーがテーブル内にフォーカスを移動させると、カスタム タブが表示されます。 ユーザーがテーブルの外に移動すると、カスタム タブは非表示になります。
Web ワーカーを使用したカスタム関数のサンプル カスタム関数で Web ワーカーを使用して、お使いの Office アドインの UI をブロックしないようにします。
ストレージ テクニックを使用してオフライン時に Office アドインからデータにアクセスする ユーザー エクスペリエンスの接続が失われた場合に、お使いの Office アドイン向けに制限された機能を有効にする localStorage を実装します。
カスタム関数のバッチ処理パターン 複数の呼び出しを単一の呼び出しにバッチ処理し、リモート サービスへのネットワーク呼び出しの回数を減らします。
Excel コンテンツ アドイン Excel グリッドにコンテンツ アドインを埋め込みます。
コンテンツ アドインでのデータの視覚化 データの視覚化を含む Excel コンテンツ アドインを作成します。
同期カスタム関数のサンプル (プレビュー) @supportSyncを使用して、Excel の計算プロセスと並行してセル値を読み取る同期カスタム関数を作成します。 この機能はパブリック プレビュー段階です。

Outlook

名前 説明
Outlook でメッセージを暗号化および暗号化解除する Outlook Smart Alerts と OnMessageDecrypt イベントを使用して、メッセージの暗号化と暗号化解除を行います。
Outlook でスパムまたはフィッシングメールを報告する Outlook クライアント リボンで簡単に検出できる統合スパムレポート ソリューションを構築します。 このソリューションでは、電子メールを報告するためのダイアログがユーザーに提供されます。 また、報告された電子メールのコピーをファイルに保存して、バックエンド システムでさらに処理します。
Outlook イベント ベースのアクティブ化を使用して、添付ファイルを暗号化し、会議出席依頼の出席者を処理し、予定の日付/時刻の変更に対応する イベント ベースのアクティブ化を使用して、ユーザーが追加したときに添付ファイルを暗号化します。 また、会議出席依頼で変更された受信者、および会議出席依頼の開始または終了の日時の変更にはイベント処理も使用します。
Outlook イベント ベースのアクティブ化を使用して外部受信者を識別してタグ付けする イベントベースのアクティブ化を使用して、ユーザーがメッセージ作成中に受信者を変更した場合に Outlook アドインを実行します。 このアドインでは、appendOnSendAsync API も使用して免責事項を追加します。
Outlook イベント ベースのアクティブ化を使用して署名を設定する イベント ベースのアクティブ化を使用して、ユーザーが新しいメッセージまたは予定を作成するときに Outlook アドインを実行します。 アドインは、作業ウィンドウが開いていない場合でも、イベントに応答できます。 このアドインでは、setSignatureAsync API も使用します。
スマート アラートを使用して送信される前に、メッセージまたは予定の色のカテゴリを確認する Outlook スマート アラートを使用して、新規メッセージまたは予定が送信される前に、必要な色の分類項目が適用されていることを確認します。
メッセージの秘密度ラベルを確認する イベント ベースのアドインで秘密度ラベル API を使用して、機密性の 高い 秘密度ラベルを検証し、適用できる送信メッセージに適用します。
操作可能なメッセージからの Outlook アドインの呼び出し アクション可能なメッセージでアダプティブ カードを使用してアドインをアクティブ化し、初期化コンテキスト データを表示します。

Word

名前 説明
Word ドキュメントが開いたときに、アドインでラベルを自動的に追加する ドキュメントが開いたときにアクティブ化するようにWord アドインを構成します。
Word アドインを使用して、Word 文書の OOXML コンテンツを取得、編集、および設定する Word ドキュメント内の OOXML コンテンツを取得、編集、設定します。 サンプル アドインは、独自のコンテンツ用に Office Open XML を取得し、独自に編集した Office Open XML スニペットをテストするため、スクラッチ パッドを提供します。
Word アドインを使用して Word 文書のテンプレートをインポートする Word ドキュメントにテンプレートをインポートします。
Word アドインに Open XML を読み込んで書き込む ooxml 強制型の setSelectedDataAsync メソッドを使用して、さまざまなリッチ コンテンツ タイプをWord ドキュメントに追加します。 また、このアドインでは、サンプル コンテンツ タイプごとに Office Open XML マークアップをページ上に表示することもできます。
Word アドインで引用文献を管理する Wordドキュメントで引用文献を管理します。

認証、承認、シングル サインオン (SSO)

名前 説明
入れ子になったアプリ認証を使用した SSO を使用した Office アドイン Office アドイン MSAL.js 入れ子になったアプリ認証 (NAA) を使用して、サインインしているユーザーの Microsoft Graph API にアクセスします。 このサンプルでは、サインインしているユーザーの名前と電子メールが表示されます。 また、ユーザーの Microsoft OneDrive アカウントのファイルの名前もドキュメントに挿入されます。
入れ子になったアプリ認証を使用した SSO を使用した Outlook アドイン Outlook アドイン MSAL.js 入れ子になったアプリ認証 (NAA) を使用して、サインインしているユーザーの Microsoft Graph API にアクセスします。 このサンプルでは、サインインしているユーザーの名前と電子メールが表示されます。 また、ユーザーの Microsoft OneDrive アカウントのファイルの名前を新しいメッセージ本文に挿入します。
Outlook アドインでイベント ベースのアクティブ化で SSO を使用する SSO を使用して、Outlook アドインで発生したイベントからユーザーの Microsoft Graph データにアクセスします。
シングル サインオン (SSO) サンプル Outlook アドイン Office の SSO 機能を使用して、アドインが Microsoft Graph データにアクセスできるようにします。
Office アドインの Microsoft Graph と msal.js を使用して OneDrive データを取得する バックエンドのないシングルページ アプリケーション (SPA) として Office アドインを構築し、Microsoft Graph に接続して、OneDrive for Businessに格納されているブックにアクセスし、スプレッドシートを更新します。
Microsoft Graph への Office アドイン認証 Microsoft Graph に接続して、OneDrive for Businessに格納されているブックにアクセスし、スプレッドシートを更新する Microsoft Office アドインを構築します。
Microsoft Graph への Outlook アドイン認証 Microsoft Graph に接続して、OneDrive for Businessに格納されているブックにアクセスし、新しい電子メール メッセージを作成する Outlook アドインを構築します。
ASP.NET を使用したシングル サインオン (SSO) Office アドイン Office.js で getAccessToken API を使用して、アドインが Microsoft Graph データにアクセスできるようにします。 このサンプルは ASP.NET で作成されています。
Node.js を使用したシングル サインオン (SSO) Office アドイン Office.js で getAccessToken API を使用して、アドインが Microsoft Graph データにアクセスできるようにします。 このサンプルは Node.js で作成されています。

Office

名前 説明
Office アドインにカスタム設定を保存する Office アドイン内にカスタム設定を保存します。 アドインは、JavaScript API for Office プロパティ バッグ、ブラウザー Cookie、Web ストレージ (localStorage と sessionStorage) を使用するか、ドキュメントの非表示の div にデータを格納することで、キーと値のペアとしてデータを格納します。
Office アドイン アクション用のキーボード ショートカットを使用する カスタム キーボード ショートカットを作成して、Office アドインに対して特定のアクションを呼び出します。
Office アドインのリボン コントロールのキーヒントを定義する Office アドインのリボン コントロールのキーヒントを定義します。

共有ランタイム

名前 説明
グローバル データを共有ランタイムと共有する 共有ランタイムを使用して、リボン ボタン、作業ウィンドウ、カスタム関数のコードを単一のブラウザー ランタイムで実行する基本的なプロジェクトを設定します。
リボンと作業ウィンドウ UI を管理し、開いたドキュメントでコードを実行する アドインの状態に基づいて有効になる状況依存のリボンのボタンを作成します。

追加サンプル

名前 説明
共有ライブラリを使用して、Visual Studio Tools for Office アドインを Office Web アドインに移行する 共有ライブラリを使用して、VSTO アドインから Office アドインに移行するときにコードを再利用します。
Azure 関数を Excel カスタム関数と統合する Azure 関数とカスタム関数を統合して、クラウドに移行したり追加サービスを統合したりします。
動的 DPI コードのサンプル COM、VSTO、および Office アドインでの DPI の変更を処理するためのサンプルのコレクションについて説明します。
OneNote on the web用ルーブリック グレーダー作業ウィンドウ アドイン 教師向けのサンプル ツールを使用して、OneNote アドインの基本を調べる。

次の手順

Microsoft 365 開発者プログラムに参加して、関心のある分野に合わせた推奨事項など、Microsoft 365 プラットフォームのソリューションを構築するのに役立つリソースと情報を取得します。

また、90 日間更新可能で、サンプル データが構成された無料の開発者サブスクリプションの対象となる場合もあります。詳細については、 FAQ を参照してください。

  • Last updated on