共用方式為

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

  • 發行項

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

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

  • 使用 Visual Studio 專案範本建立網站定義。

  • 使用 SharePoint 中的網站定義建立 SharePoint 網站。

  • 將視覺 Web 組件加入至方案。

  • 將新的視覺 Web 組件加入網站的 default.aspx 頁面來自訂它。

注意事項注意事項

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

必要條件

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

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

  • Visual Studio 2010。

建立網站定義方案

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

若要建立網站定義專案

  1. 指向 [檔案] 功能表上的 [新增]，然後按一下 [專案]，顯示 [新增專案] 對話方塊。

  2. 展開 [Visual C#] 或 [Visual Basic] 底下的 [SharePoint] 節點，然後按一下 [SharePoint]，再按一下 [2010]。

  3. 在 [範本] 窗格中，選取 [網站定義]。

  4. 在 [名稱] 方塊中輸入 TestSiteDef，然後按一下 [確定]。

    [SharePoint 自訂精靈] 隨即出現。

  5. 在 [指定網站和安全性層級進行偵錯] 頁面上，輸入您想要偵錯網站定義之 SharePoint 伺服器網站的 URL，或使用預設位置 (http://system name/)。

  6. 在 [此 SharePoint 方案的信任層級為何?] 區段中，使用 [部署為陣列方案] 預設值。

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

  7. 按一下 [完成]。 專案隨即出現在 [方案總管] 中。

建立視覺 Web 組件

接下來，建立顯示在網站定義主頁面上的視覺 Web 組件。

若要建立視覺 Web 組件

  1. 按一下 [專案] 功能表上的 [加入新項目]，顯示 [加入新項目] 對話方塊。

  2. 按一下 [方案總管] 中的 [顯示所有檔案] 按鈕，顯示所有檔案。

  3. 在 [已安裝的範本] 樹狀檢視中，依序選取 [Visual Basic] 或 [Visual C#] 節點、[SharePoint] 和 [2010]，然後按一下專案項目範本清單中的 [視覺 Web 組件]。 請使用預設名稱 VisualWebPart1。

    這會開啟 VisualWebPart1UserControl.ascx 檔案。

  4. 在 VisualWebPart1UserControl.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>

  5. 開啟位於 VisualWebPart1UserControl.ascx 底下的 VisualWebPart1UserControl.ascx.cs (適用於 Visual C#) 或 VisualWebPart1UserControl.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 網頁

  1. 開啟 default.aspx 網頁，然後在 WebPartPages 標記底下加入下列程式碼：

    <%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.SiteDefinition.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>

    這一行會將名稱 MyWebPartControls 與 Web 組件及其程式碼相關聯。 Namespace 參數和 VisualWebPart1Usercontrol.ascx 程式碼檔中使用的命名空間相同。

  2. 在 </asp:Content> 項目之後，將整個 ContentPlaceHolderId="PlaceHolderMain" 區段及其內容取代成下列程式碼：

    <asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
    <MyWebPartControls:VisualWebPart1 runat="server" />    
</asp:Content>

    這段程式碼會建立您先前所建立之視覺 Web 組件的參考。

執行和部署網站定義方案

接下來，執行專案並將它部署至 SharePoint。

若要執行和部署網站定義

  • 按 F5。 Visual Studio 會編譯程式碼、加入其功能、將所有檔案封裝至 WSP 檔案，然後將 WSP 檔案部署至 SharePoint 伺服器。 SharePoint 接著會安裝檔案並啟動功能。

根據網站定義建立網站

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

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

  1. SharePoint 網站上隨即出現 [新增 SharePoint 網站] 頁面。

  2. 在 [標題和說明] 區段中，輸入「我的新網站」做為標題，並輸入網站的描述。

  3. 在 [網站位址] 區段的 [URL 名稱] 方塊中，輸入 mynewsite。

  4. 在 [範本] 區段中，按一下 [SharePoint 自訂] 索引標籤，然後按一下 [選取範本] 清單中的 [TestSiteDef]。

  5. 保留其他設定的預設值，然後按一下 [建立]。

    新網站隨即出現。

測試新網站

接下來，測試新網站來確定是否正常運作。

若要測試新網站

  • 在預設 ASPX 網頁的文字方塊中輸入一些文字，然後按一下文字方塊旁的小方形按鈕。

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

請參閱

工作

HOW TO：建立事件接收器

其他資源

逐步解說：使用其他內容建立網站定義

開發 SharePoint 方案