SharePoint の Web パーツの作成

[アーティクル]
08/09/2011

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

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

Visual Studio での Web パーツの作成

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

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

Web パーツ項目

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

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

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

可視 Web パーツ項目

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

機能上では可視 Web パーツと Web パーツに違いはありません。 可視 Web パーツ項目には、Web パーツ項目とユーザーコントロール項目が含まれています。

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

Web パーツのデバッグ

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

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

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

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

Visual Studio のテンプレートを使用すると、SharePoint の ASP.NET 2.0 Web パーツを作成できます。 ASP.NET 2.0 Web パーツは、ASP.NET Web パーツインフラストラクチャの最上位にビルトされるため、この種類は新しいプロジェクトにお勧めします。

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

古い形式の SharePoint に基づく Web パーツの作成が適しているケースの詳細については、「SharePoint Foundation の Web パーツインフラストラクチャ」を参照してください。古い形式の SharePoint に基づく Web パーツを使用して Web パーツを作成する方法の詳細については、「Walkthrough Creating a Basic SharePoint Web Part (チュートリアル: 基本的な SharePoint Web パーツを作成する)」を参照してください。

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

次の方法で共有