SharePoint の Web パーツの作成

Webパーツを使用して、userがブラウザーから直接SharePointサイト ページのコンテンツ、外観、および動作を変更できます。Webパーツは、Webパーツ ページと呼ばれる特殊な種類のページ内で実行されるサーバー側のコントロールです: また、SharePointサイトに表示されるページのビルド ブロックです。SharePointのWebパーツに関する詳細については、" "を参照してください。ビルド ブロック: [Web パーツ]

Visual Studioには、SharePointサイトのWebパーツを作成し、デバッグに使用できるテンプレートが用意されています。

Visual Studio での Web パーツの作成

任意のSharePointプロジェクトに [Web パーツ] 項目を追加して、Webパーツを作成します。サンドボックス ソリューションまたはファーム ソリューションに Web パーツ項目を使用できます。

デザイナーを使用して視覚的にデザインする場合は、[視覚的 Web パーツ] のプロジェクトを作成するか、または任意のSharePointプロジェクトに [視覚的 Web パーツ] の項目をWebパーツを追加します。可視 Web パーツ項目を使用できるのは、ファーム ソリューションのみです。

Web パーツ項目

[Web パーツ] の項目は、SharePointサイトのWebパーツをデザインするために使用できるファイルを提供します。[Web パーツ] の項目を追加すると、Visual Studioはプロジェクトのフォルダーが作成され、そのフォルダーにいくつかのファイルが追加されます。各ファイルの説明を次の表に示します。

ファイル	説明
Elements.xml	Webパーツを配置するには、プロジェクトの機能定義ファイルが使用する情報が格納されます。
.webpart ファイル	Webパーツ ギャラリーのWebパーツを表示することをSharePointに必要な情報を提供します。
コード ファイル	コントロールを追加するWebパーツにWebパーツ内にカスタム コンテンツを生成し、メソッドが含まれています。

詳細については、「方法: SharePoint Web パーツを作成する」を参照してください。

可視 Web パーツ項目

可視Webパーツは、Visual StudioのVisual Web Developerデザイナーを使用して作成するWebパーツです。このデザイナーを使用する方法の詳細については、Web コンテンツのマップの Visual Studio 11 の Betaを参照してください。

機能的には、Visual Webパーツは、Webパーツと同じです。可視 Web パーツ項目には、Web パーツ項目とユーザー コントロール項目が含まれています。

Visual Studio [ツールボックス] ドラッグ、またはコピーして、Webパーツの外観をからユーザー コントロールのサーフェイスにコントロールをデザインできます。詳細については、「方法: デザイナーを使用して SharePoint Web パーツを作成する」を参照してください。

SharePoint コントロール

Visual Studioは、アプリケーション ページなどのSharePointページを作成するためのコントロールを提供します。これらのコントロールは **[SharePoint コントロール]**でツールボックスに表示されます。これらのコントロールの機能は、SharePointサイトで使用され、ページを示すASP.NETサーバー コントロールを含む名前空間 Microsoft.SharePoint.WebControls から派生します。

コントロール名	説明
AspMenu	ASPのメニューを挿入します。詳細については、メニュー コントロールの概要" "を参照してください。
CssLink	CssRegistrationで定義されている LINK の要素を.aspxページに挿入され、一つ以上の外部スタイル シートを追加します。
DateTimeControl	.aspxページにDateTimeのコントロールを挿入します。
FormDigest	.aspxページにセキュリティの検証を挿入します。
ListProperty	指定されたリストのプロパティを返します。
ProjectProperty	現在のWebサイトのグローバル プロパティを返します。
RssLink	.aspxページにRSSフィードへのリンクを挿入します。
ScriptLink	ページがレンダリングされるときに要求できるように、ページでリソースを、スクリプトなど、登録するプロパティとメソッドを提供します。
テーマ	.aspxページにテーマを適用します。

Web パーツのデバッグ

他のVisual StudioプロジェクトをデバッグするWebパーツを含むSharePointプロジェクトをデバッグできます。Visual Studio デバッガーを開始すると、SharePoint サイトが開きます。

コードのデバッグを開始するには、SharePointのWebパーツ ページにWebパーツを追加します。

SharePoint プロジェクトのデバッグ方法の詳細については、「SharePoint ソリューションのトラブルシューティング」を参照してください。

Visual Webパーツの制限

Visual Studioでは、サンドボックスSharePointソリューションに可視Webパーツを追加し、ファーム ソリューションをできます。ただし、Visual Webパーツ、次の制限が適用されます:

• 可視Webパーツは、置き換え可能なパラメーターをサポートしません。詳細については、「置き換え可能パラメーター」を参照してください。

• ユーザー コントロールまたはVisual Webパーツは、Visual Webパーツにドラッグし、削除またはコピーすることはできません。この操作により、ビルド エラーが発生します。

• 可視Webパーツは直接$SPUrlなどのSharePointサーバーのトークンをサポートしていません。詳細については、「"のトピック SharePoint ソリューションのトラブルシューティングのサンドボックスのVisual Webパーツのトークン制限」を参照してください。

• サンドボックス ソリューションのVisual Webパーツは、ときどきエラーが発生したため、「Allコードがホスト サービス要求を処理するには、ビジー」。がサンドボックス ソリューション コードの実行要求断られましたこのエラーの詳細については、この後の SharePoint開発者チームのブログ"を参照してください。

• サーバー側のJavaScriptのデバッグ、Visual Studioでサポートされていませんが、JavaScriptのクライアント側のデバッグ サポートされます。

  サーバー側のマークアップ ファイルにインラインJavaScriptを追加できますが、デバッグ マークアップに追加されたブレークポイントではサポートされません。JavaScriptをデバッグするには、外部のJavaScriptファイルをマークアップ ファイルで参照し、JavaScriptファイルにブレークポイントを設定します。

• ASP.NET インライン コードのデバッグはマークアップ ファイルではなく、生成されたコード ファイルで実行する必要があります。

• 可視Webパーツは <@ Assembly Src= ディレクティブの使用をサポートしていません。

• SharePoint Webコントロールと ASP.NET の一部のコントロールはサンドボックスSharePoint環境ではサポートされていません。サポートされていないコントロールはサンドボックス ソリューションでVisual Webパーツで使用すると、エラー、「型または名前空間名"テーマ」は名前空間「」Microsoft.SharePoint.WebControlsに」ありません。

サンドボックス ソリューションに関する詳細については、サンドボックス ソリューションとファーム ソリューションの違いを参照してください。

古い形式の SharePoint に基づく Web パーツの作成

Visual StudioでSharePointのカスタム ASP.NET 2.0 Webパーツを作成するテンプレートを使用できます。ASP.NET 2.0 Webパーツは ASP.NET Webパーツ インフラストラクチャ上に構築、新しいプロジェクトの推奨される型です。

きわめてまた、古い形式のSharePointに基づくWebパーツを使用してWebパーツを作成する必要があります。Webパーツの種類を作成するためにVisual Studioを使用できますが、Visual Studioは、それらを作成できるようにデザインされたテンプレートはありません。

詳細については、に関する古い形式のSharePointに基づくWebパーツを作成する可能性がある場合は、" "を参照してください。Windows SharePoint Services Webパーツ インフラストラクチャ古い形式のSharePointに基づくWebパーツを使用してWebパーツを作成する方法の詳細については、" "を参照してください。基本的なSharePoint Webパーツを作成するチュートリアル

関連トピック

タイトル	説明
方法: SharePoint Web パーツを作成する	SharePointページのWebパーツを作成する方法を示します。
方法: デザイナーを使用して SharePoint Web パーツを作成する	ビジュアル デザイン サーフェイスを使用して、SharePointのWebパーツを作成する方法を示します。
方法: SharePoint アプリケーション ページまたは Web パーツのユーザー コントロールを作成する	カスタム、SharePointで実行されるアプリケーション ページとWebパーツ実行できる再利用可能なコントロールを作成する方法を示します。
チュートリアル: SharePoint の Web パーツを作成する	SharePointのWebパーツをデザインする方法について説明します。
チュートリアル: デザイナーを使用した SharePoint の Web パーツの作成	ビジュアル デザイン サーフェイスにコントロールをドラッグして、SharePointのWebパーツをデザインする方法について説明します。
チュートリアル: SharePoint の OData を表示する Silverlight Web パーツの作成	Silverlightアプリケーションをホストする、SharePointリストからデータを表示するSharePointのWebパーツをデザインする方法について説明します。
Visual Web Developer の操作	プロジェクトのWebページを開くと表示されるデザイナーの使用方法について説明します。