逐步解說：建立基本網站定義專案

發行項
03/12/2013

本逐步解說示範如何建立基本網站定義，其中包含上面有一些控制項的視覺 Web 組件。為能清楚說明，您所建立的視覺 Web 組件只有幾個控制項。不過，您可以建立包含更多功能、更複雜的 SharePoint 網站定義。

本逐步解說將示範下列工作：

使用 Visual Studio 專案範本建立網站定義。
使用 SharePoint 中的網站定義建立 SharePoint 網站。
將視覺 Web 組件加入至方案。
將新的視覺 Web 組件加入網站的 default.aspx 頁面來自訂它。

注意事項
您的電腦可能會在下列說明中，以不同名稱或位置顯示某些 Visual Studio 使用者介面項目。您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。如需詳細資訊，請參閱 Visual Studio 設定。

必要條件

您需要下列元件才能完成此逐步解說：

支援的 Microsoft Windows 和 SharePoint 版本。如需詳細資訊，請參閱＜開發 SharePoint 方案的要求＞。
Visual Studio。

建立網站定義方案

首先，在 Visual Studio 中建立網站定義專案。

若要建立網站定義專案

在功能表列上，選擇 [檔案]、[新增]、[專案]。如果您的 IDE 設定為使用 Visual Basic 開發設定，請在功能表列上，選擇 [檔案]]，則 [新的專案]。

[新增專案] 對話方塊隨即出現。
展開 [Visual C#] 節點或 [Visual Basic] 節點，然後展開 [SharePoint] 節點，然後選取 [2010 年] 節點。
在 [範本] 清單中，選取 [SharePoint 2010 專案] 範本。
在 [名稱] 方塊中，輸入 TestSiteDef，然後選擇 [OK] 按鈕。

[SharePoint 自訂精靈] 隨即出現。
在 [若要指定偵錯網站和安全性層級] 頁面上，輸入您要偵錯網站定義的 SharePoint 網站的 URL，或使用預設位置 (http://系統名稱/)。
在 [什麼是這個 SharePoint 方案的信任層級?] 區段中，選擇 [部署為陣列方案] 選項按鈕。

所有網站定義專案都必須部署為陣列方案。如需沙箱化方案與陣列方案的比較的詳細資訊，請參閱沙箱化方案考量。
選取 [完成] 按鈕。

專案隨即出現在 [方案總管] 中。
在 [方案總管] 中，選取專案節點，然後，在功能表列上，選擇 [專案]]，則 [加入新項目。]。
在 [Visual C#] 或 [Visual Basic] 底下，展開 [SharePoint] 節點，然後選取 [2010 年] 節點。
在 [範本] 窗格中，選取 [網站定義] 範本，將 [名稱] 保留為 [SiteDefinition1]]，然後選擇 [加入] 按鈕。

建立視覺 Web 組件

接下來，建立視覺 Web 組件出現在網站定義的首頁。

若要建立視覺 Web 組件

在 [方案總管] 中，選取 [顯示所有檔案] 按鈕。
選取 [SiteDefinition1] 專案節點，然後，在功能表列上，選擇 [專案]]，則 [加入新項目。]。

[加入新項目] 對話方塊隨即出現。
展開 [Visual C#] 節點或 [Visual Basic] 節點，然後展開 [SharePoint] 節點，然後選取 [2010 年] 節點。
在範本清單中，選取 [視覺 Web 組件] 範本，並保留預設名稱 VisualWebPart1，然後選擇 [加入] 按鈕。

VisualWebPart1.ascx 檔案隨即開啟。

在 VisualWebPart1.ascx 下方加入下列標記，將三個控制項加入至表單:文字方塊、按鈕和標籤:

<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 組件的按一下按鈕動作的功能。

將視覺 Web 組件加入至預設 ASPX 網頁

接下來，將視覺 Web 組件加入至網站定義的預設 ASPX 網頁。

若要將視覺 Web 組件加入至預設 ASPX 網頁

開啟 default.aspx 頁面，然後將下行程式碼 WebPartPages 標記下方:
```
<%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
```
這一行會將名稱關聯 MyWebPartControls 與 Web 組件及其程式碼。Namespace 參數符合 VisualWebPart1.ascx 程式碼檔案中的命名空間。
在 </asp:Content> 項目之後，請取代整個 ContentPlaceHolderId="PlaceHolderMain" 區段及其內容與下列程式碼:
```
<asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
    <MyWebPartControls:VisualWebPart1 runat="server" />    
</asp:Content>
```
這段程式碼會建立您先前所建立之視覺 Web 組件的參考。
在 [方案總管] 中，開啟 [SiteDefinition1] 節點的捷徑功能表，然後選擇 [做為起始的項目集合。]。

部署和執行網站定義方案

接下來，將專案部署至 SharePoint，然後執行專案。

執行和部署網站定義

在功能表列上，選擇 [組建]]，則 [部署 TestSiteDef]。
選擇 F5 鍵。

Visual Studio 會編譯程式碼，並將它的功能，這些功能、將所有檔案封裝至 SharePoint 方案 (WSP) 檔案，而部署 WSP 檔案複製到 SharePoint 伺服器。SharePoint 接著會安裝檔案並啟動功能。

根據網站定義建立網站

接下來，使用新網站定義建立網站。

若要使用網站定義建立網站

SharePoint 網站上隨即出現 [新增 SharePoint 網站] 頁面。
在 [標題和說明] 區段中，輸入「我的新網站」做為標題，並輸入網站的描述。
在 [網站位址] 區段的 [URL 名稱] 方塊中，輸入 mynewsite。
在 [範本] 區段中，選取 [SharePoint 自訂] 選項。
在 [選取範本] 清單中，選取 [SiteDefinition1]。
保留其他設定的預設值，然後選擇 [建立] 按鈕。

新網站隨即出現。

測試新網站

接著，測試新網站驗證它是否正確運作。

若要測試新網站

在預設 ASPX 頁面上，輸入一些文字，文字方塊旁邊然後選擇 [變更標籤的文字。] 按鈕。

文字會出現在標籤中按鈕的右邊。

共用方式為