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 の計算プロセスと並行してセル値を読み取る同期カスタム関数を作成します。 この機能はパブリック プレビュー段階です。
Copilot in Excel のスキル (プレビュー) Office JavaScript ライブラリの Excel 固有の API を使用する Excel の Copilot のカスタム スキルを作成します。 この機能はパブリック プレビュー段階です。

Outlook

名前 説明
Outlook でメッセージを暗号化および復号化する Outlook スマート アラートと 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 アドイン内にカスタム設定を保存します。 アドインは、Office プロパティ バッグ、ブラウザー cookie、Web ストレージ (localStorage および sessionStorage) の JavaScript API を使用するか、ドキュメントの非表示の div にデータを格納することで、キーと値のペアとしてデータを格納します。
Office アドイン アクション用のキーボード ショートカットを使用する 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