チュートリアル: 基本サイト定義プロジェクトの作成

このチュートリアルでは、可視 Web パーツとそこに配置されたいくつかのコントロールを含んだ基本的なサイト定義を作成する方法について説明します。わかりやすく説明するために、ここで作成する可視 Web パーツには数個のコントロールしか配置されていないことにします。実用するために、より多機能な洗練された SharePoint サイト定義を作成することはできます。

このチュートリアルでは、次のタスクを実行します。

Visual Studio プロジェクトテンプレートを使用してサイト定義を作成する。
SharePoint でサイト定義を使用して SharePoint サイトを作成する。
可視 Web パーツをソリューションに追加する。
サイトの default.aspx ページに新しい可視 Web パーツを追加してカスタマイズする。

[!メモ]

お使いのマシンで、Visual Studio ユーザーインターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

必須コンポーネント

このチュートリアルを実行するには、次のコンポーネントが必要です。

サポート対象エディションの Microsoft Windows および SharePoint。詳細については、「SharePoint ソリューションの開発要件」を参照してください。
Visual Studio

サイト定義ソリューションの作成

まず、Visual Studio でサイト定義プロジェクトを作成します。

サイト定義プロジェクトを作成するには

メニューバーで [ファイル]、[新規]、[プロジェクト] の順にクリックします。Visual Basic 開発設定を、メニューバーで使用する IDE が設定された [ファイル]、[新しいプロジェクト] を選択します。

[新しいプロジェクト] ダイアログボックスが表示されます。
[Visual C#] のノードまたは [Visual Basic] のノードを展開し、SharePoint ノードを展開し、を [2010] のノードを選択します。
[テンプレート] の一覧で、[SharePoint 2010 プロジェクト] テンプレートを選択します。
[名前] ボックスに" TestSiteDef "を入力し、を [OK] のボタンをクリックします。

SharePoint カスタマイズウィザードが表示されます。
[デバッグのサイトとセキュリティレベルの指定] のページで、サイト定義をデバッグする入力するか、既定の場所 (http://システム名/) を使用して SharePoint サイトの URL。
[この SharePoint ソリューションの信頼レベル] のセクションでは、[ファームソリューションとして配置する] のオプションボタンを選択します。

サイト定義プロジェクトはすべてファームソリューションとして配置する必要があります。サンドボックスソリューションとファームソリューションの違いの詳細については、「サンドボックスソリューションの考慮事項」を参照してください。
[完了] のボタンをクリックします。

ソリューションエクスプローラーにプロジェクトが表示されます。
次に [ソリューションエクスプローラー] で、プロジェクトノードを選択し、メニューバーで、をクリックします [新しい項目の追加]、プロジェクトを選択します。
[Visual C#] か [Visual Basic] の下で、SharePoint ノードを展開し、[2010] のノードを選択します。
[テンプレート] のペインで、[サイト定義] テンプレートを選択し、[SiteDefinition1] として [名前] を残し、[追加] のボタンをクリックします。

可視 Web パーツの作成

次に、サイト定義のメインページに表示する可視 Web パーツを作成します。

可視 Web パーツを作成するには

[ソリューションエクスプローラー] では、[すべてのファイルを表示] のボタンをクリックします。
次に [SiteDefinition1] のプロジェクトノードを選択し、メニューバーのをクリックし、プロジェクト、[新しい項目の追加] を選択します。

[新しい項目の追加] ダイアログボックスが表示されます。
[Visual C#] のノードまたは [Visual Basic] のノードを展開し、SharePoint ノードを展開し、を [2010] のノードを選択します。
テンプレートの一覧で、[視覚的 Web パーツ] テンプレートを選択し、既定の名前の VisualWebPart1 を保持し、次に [追加] のボタンをクリックします。

VisualWebPart1.ascx でファイルが開きます。

VisualWebPart1.ascx の下部に、フォームに 3 のコントロールを追加するには次のマークアップを追加します: テキストボックス、ボタン、ラベル:

<table>
  <tr>
    <td>
      <asp:TextBox runat="server" ID="tbName"></asp:TextBox>
    </td>
    <td>
      <asp:Button runat="server" ID="btnSubmit" Text = "Change Label Text" OnClick="btnSubmit_Click"></asp:Button>
    </td>
    <td>
      <asp:Label runat="server" ID="lblName"></asp:Label>
    </td>
  </tr>
</table>

VisualWebPart1.ascx の下に、VisualWebPart1.ascx.cs ファイル (Visual C#の場合) または VisualWebPart1.ascx.vb を Visual Basic (の場合) を開き、次のコードを追加します:
```
Protected Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
    lblName.Text = tbName.Text
End Sub
```
```
protected void btnSubmit_Click(object sender, EventArgs e)
{            
    lblName.Text = tbName.Text;
}
```
このコードによって、Web パーツのボタンクリック用の機能が追加されます。

既定の ASPX ページへの可視 Web パーツの追加

次に、可視 Web パーツをサイト定義の既定の ASPX ページに追加します。

可視 Web パーツを既定の ASPX ページに追加するには

default.aspx ページを開き、WebPartPages のタグの下に次の行を追加します:
```
<%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
```
この行は、Web パーツ、コードと名前 MyWebPartControls を関連付けます。Namespace のパラメーターは VisualWebPart1.ascx コードファイルで使用される名前空間と一致します。
</asp:Content> の要素の後に、次のコードの ContentPlaceHolderId="PlaceHolderMain" のセクションとその内容を置き換えます。:
```
<asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
    <MyWebPartControls:VisualWebPart1 runat="server" />    
</asp:Content>
```
先ほど作成した可視 Web パーツへの参照がこのコードによって作成されます。
[ソリューションエクスプローラー] では、[SiteDefinition1] のノードのショートカットメニューを開き、[スタートアップアイテムとして設定] を選択します。

サイト定義ソリューションを配置し、実行します。

次に、プロジェクトを SharePoint に配置し、プロジェクトを実行します。

サイト定義を展開し、実行するには

メニューバーで、[ビルド]、[Deploy TestSiteDef] を選択します。
F5 キーを選択します。

Visual Studio では、SharePoint ソリューション (WSP) ファイルにコードを追加機能をパッケージ化し、すべてのファイル (SharePoint サーバーに配置します WSP ファイルをコンパイルします。さらに、SharePoint によってファイルがインストールされて、フィーチャーがアクティブ化されます。

サイト定義に基づくサイトの作成

次に、新しいサイト定義を使用してサイトを作成します。

サイト定義を使用してサイトを作成するには

SharePoint サイトでは、[新しい SharePoint サイト] ページが表示されます。
[タイトルと説明] セクションで、サイトのタイトルと説明に「My New Site」と入力します。
[Web サイトのアドレス] セクションの [URL 名] ボックスに「mynewsite」と入力します。
[テンプレート] のセクションでは、[SharePoint のカスタマイズ] のタブをクリックします。
[テンプレートの選択] の一覧で、[SiteDefinition1] を選択します。
他の設定は既定値のままにして、をに [作成] のボタンをクリックします。

新しいサイトが表示されます。

新しいサイトのテスト

次に、正しく動作するかどうかを確認するために、新しいサイトをテストします。

新しいサイトをテストするには

既定の ASPX ページで、テキストを入力し、テキストボックスの横に [Change Label Text] のボタンをクリックします。

テキストは、ボタンの右側のラベルに表示されます。

参照

処理手順

方法: イベントレシーバーを作成する

その他の技術情報

SharePoint ソリューションの開発

Last updated on 2013-03-12