重要
SharePoint アドインは、2026 年 4 月 2 日に SharePoint Online のサポートが終了しました。 SharePoint でホストされているアドインとプロバイダーでホストされているアドインはどちらも廃止され、政府機関向けクラウドを含む SharePoint Online では機能しなくなります。 アドインの開発、展開、使用に関するガイダンスは、新しい SharePoint Online ソリューション用ではなく、履歴参照と該当する SharePoint Server シナリオ用に保持されます。
オンプレミスのアプリ カタログを通じて展開された SharePoint Server アドインは、この変更によって廃止されません。 パブリック マーケットプレースからの SharePoint アドインの取得は、SharePoint Server の 2026 年 4 月 2 日に終了しました。
この廃止により、SharePoint REST API、CSOM、JSOM、または SharePoint Framework (SPFx) は廃止されません。 SharePoint Online の場合は、ユーザー インターフェイス拡張機能に SPFx を使用し、外部アプリケーションへの認証に Microsoft Entra ID を使用します。 廃止のお知らせとアドインの移行ガイダンスを参照してください。
新しい SharePoint アドイン モデルにおいて、リスト インスタンスを作成する方法は、完全信頼コードの場合とは異なります。 一般的な完全信頼コード (FTC)/ ファーム ソリューション シナリオでは、リスト インスタンスは宣言型コードを使用して作成され、SharePoint ソリューションを使用して展開されていました。
SharePoint アドイン モデル シナリオでは、リモート プロビジョニング パターンを使用してリスト インスタンスが作成されます。
基本ガイドライン
リスト インスタンスの作成については、大まかに次のような基本ガイドラインが提供されています。
- リスト インスタンスの作成には、リモート プロビジョニング パターンを使用します。
- リスト インスタンスの作成に宣言型コード (elements.xml) を使用しないでください。
はじめに
次の PnP O365 コードのサンプルとビデオは、ユーザー インターフェイスを提供する SharePoint アドインを作成し、そこでエンド ユーザーに新しいドキュメント ライブラリの作成を許可する方法を示しています。 また、まとめてテンプレートとなる特定の構成を使用してドキュメント ライブラリを作成する方法についても示します。 このサンプルでは、リスト インスタンスを作成するコードを示します。
次のビデオでは、コードのサンプルについて説明します。
リモート プロビジョニング パターンからリスト インスタンスを作成するには、SharePoint CSOM で AddList メソッドを使用します。 次のコードはこの方法を示した ECM.DocumentLibraries (O365 PnP コード サンプル) の抜粋です。
private void CreateLibrary(ClientContext ctx, Library library, string associateContentTypeID)
{
if (!ctx.Web.ListExists(library.Title))
{
// Create List Instance
ctx.Web.AddList(ListTemplateType.DocumentLibrary, library.Title, false);
List _list = ctx.Web.GetListByTitle(library.Title);
//Set Description
if(!string.IsNullOrEmpty(library.Description))
{
_list.Description = library.Description;
}
//Turn on versioning
if(library.VerisioningEnabled) {
_list.EnableVersioning = true;
}
//Turn on Content Types
_list.ContentTypesEnabled = true;
_list.Update();
//Add Content Type to List
ctx.Web.AddContentTypeToListById(library.Title, associateContentTypeID, true);
//Remove the default Document Content Type
_list.RemoveContentTypeByName(ContentTypeManager.DEFAULT_DOCUMENT_CT_NAME);
ctx.Web.Context.ExecuteQuery();
}
}
次のコード サンプルは、SharePoint REST API でリスト インスタンスを作成する方法を示しています。 このサンプルは、リストおよびリスト アイテム REST API リファレンス (MSDN 記事) の抜粋です
executor.executeAsync({
url: "<app web url>/_api/SP.AppContextSite(@target)/web/lists
?@target='<host web url>'",
method: "POST",
body: "{ '__metadata': { 'type': 'SP.List' }, 'AllowContentTypes': true, 'BaseTemplate': 100,
'ContentTypesEnabled': true, 'Description': 'My list description', 'Title': 'Test title' }",
headers: { "content-type": "application/json;odata=verbose" },
success: successHandler,
error: errorHandler
});
関連リンク
- リストおよびリスト アイテム REST API リファレンス (MSDN 記事)
- リスト定義とリスト テンプレート (SharePoint アドイン モデル レシピ)
- アプリケーション モデルを使用したドキュメントとリストのテンプレート (O365 PnP ビデオ)
- ガイダンスダンス記事https://aka.ms/OfficeDevPnPGuidance
- MSDN の参考 https://aka.ms/OfficeDevPnPMSDN
- ビデオ at https://aka.ms/OfficeDevPnPVideos
PnP サンプル
適用対象
- Office 365 マルチテナント (MT)
- Office 365 専用 (D) 一部
- SharePoint 2013 オンプレミス - 一部
専用およびオンプレミスの場合のパターンは SharePoint アドイン モデル手法と同じですが、使用可能なテクノロジは異なる可能性があります。