共用方式為

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

  • 發行項

本逐步解說為您示範如何建立包含具有某些控制項之視覺 Web 組件的基本網站定義。 為了清楚起見，您建立的視覺 Web 組件只有少數控制項。 不過，您可以建立更複雜的 SharePoint 網站定義，其中包含更多功能。

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

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

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

  • 將視覺 Web 組件新增至解決方案。

  • 藉由將新的視覺 Web 組件新增至網站，自訂網站的 default.aspx 頁面。

    注意

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

必要條件

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

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

  • Visual Studio。

建立網站定義解決方案

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

建立網站定義專案

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

    [新增專案] 對話方塊隨即出現。

  2. 展開 [Visual C#] 節點或 [Visual Basic] 節點，展開 [SharePoint] 節點，然後選擇 [2010] 節點。

  3. 在 [範本] 清單中，選擇 [SharePoint 2010 專案] 範本。

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

    SharePoint 自訂精靈隨即出現。

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

  6. 在 [此 SharePoint 解決方案的信任層級為何？] 區段中，選擇 [部署為陣列方案] 選項按鈕。

    所有網站定義專案都必須部署為伺服器陣列解決方案。 如需有關沙箱化方案和伺服器陣列方案的詳細資訊，請參閱沙箱化解決方案考量。

  7. 選擇 [完成] 按鈕。

    專案隨即出現在 [方案總管] 中。

  8. 在 [方案總管] 中選擇專案節點，然後在功能表列上選擇 [專案]> [加入新項目]。

  9. 在 [Visual C#] 或 [Visual Basic] 底下展開 [SharePoint] 節點，然後選擇 [2010] 節點。

  10. 在 [範本] 窗格中，選擇 [網站定義] 範本，將 [名稱] 保留為 SiteDefinition1，然後選擇 [新增] 按鈕。

建立視覺 Web 組件

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

建立視覺 Web 組件

  1. 在 [方案總管] 中，選擇 [顯示所有檔案] 按鈕。

  2. 選擇 SiteDefinition1 專案節點，然後在功能表列上選擇 [專案]> [加入新項目]。

    [加入新項目] 對話方塊隨即出現。

  3. 展開 [Visual C#] 節點或 [Visual Basic] 節點，展開 [SharePoint] 節點，然後選擇 [2010] 節點。

  4. 在範本清單中，選擇 [視覺 Web 組件] 範本、保留預設名稱 VisualWebPart1，然後選擇 [新增] 按鈕。

    VisualWebPart1.ascx 檔案隨即開啟。

  5. 在 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>

  6. 在 VisualWebPart1.ascx 底下，開啟 VisualWebPart1.ascx.cs 檔案 (適用於 Visual C#) 或 VisualWebPart1.ascx.vb (適用於 Visual Basic)，然後新增下列程式碼：

    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.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>

    這一行會將名稱 MyWebPartControls 與 Web 組件及其程式碼產生關聯。 Namespace 參數會比對 VisualWebPart1.ascx 程式碼檔案中使用的命名空間。

  2. 在 </asp:Content> 元素後面，以下列程式碼取代整個 ContentPlaceHolderId="PlaceHolderMain" 區段及其內容：

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

    此程式碼會建立您稍早所建立視覺 Web 組件的參考。

  3. 在 [方案總管] 中，開啟 SiteDefinition1 節點的捷徑功能表，然後選擇 [設定為啟始項目]。

部署和執行網站定義解決方案

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

若要部署和執行網站定義

  • 在功能表列上，選擇 [建置]> [部署 TestSiteDef]。

  • 選擇 F5 鍵。

    Visual Studio 會編譯程式碼、新增其功能、將所有檔案封裝到 SharePoint 解決方案 (WSP) 檔案，並將 WSP 檔案部署至 SharePoint Server。 SharePoint 接著會安裝檔案，然後啟動功能。

根據網站定義建立網站

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

使用網站定義建立網站

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

  2. 在 [標題和描述] 區段中，輸入 [我的新網站] 作為網站的標題和描述。

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

  4. 在 [範本] 區段中，選擇 [SharePoint 自訂] 索引標籤。

  5. 在 [選取範本] 清單中，選擇 [SiteDefinition1]。

  6. 保留其他設定的預設值，然後選擇 [建立] 按鈕。

    新網站隨即出現。

測試新的網站

接下來，測試新的網站以確認其是否正常運作。

測試新網站

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

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

相關內容