演练：创建基本网站定义项目

  • 项目

本演练演示如何创建包含一个可视 Web 部件（此部件上有一些控件）的基本网站定义。 为了清楚起见，创建的可视 Web 部件只具有几个控件。 不过，您可以创建包括更多功能的更复杂的 SharePoint 网站定义。 有关更多信息，请参见演练：创建带有其他内容的网站定义。

本演练将演示以下任务：

  • 使用 Visual Studio 项目模板创建一个网站定义。

  • 使用 SharePoint 中的网站定义创建一个 SharePoint 网站。

  • 向解决方案中添加一个可视 Web 部件。

  • 对网站的 default.aspx 页进行自定义，在其中添加新的可视 Web 部件。

提示

对于在以下说明中使用的某些 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 Server 网站的 URL，或者使用默认位置 (http://系统名称/)。

  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 部件的按钮单击功能。

向默认 ASPX 页中添加可视 Web 部件

接下来，将可视 Web 部件添加到网站定义的默认 ASPX 页中。

向默认 ASPX 页中添加可视 Web 部件

  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 Server。 然后，SharePoint 将安装相关文件并激活相关功能。

基于网站定义创建网站

接下来，将使用新网站定义来创建网站。

使用网站定义创建网站

  1. 在 SharePoint 网站上，将出现“新建 SharePoint 网站”页。

  2. 在**“标题和说明”**部分中，输入“我的新网站”作为标题并输入有关网站的说明。

  3. 在**“网站地址”部分中，将 mynewsite 输入到“URL 名称”**框中。

  4. 在**“模板”部分中，单击“SharePoint 自定义设置”选项卡，然后选择“选择模板”列表中的“TestSiteDef”**。

  5. 将其他设置保留为其默认值，然后单击**“创建”**。

    新网站将出现。

测试新网站

接下来，将测试新网站以确保它能够正常工作。

测试新网站

  • 在默认 ASPX 页上的文本框中，输入一些文本，然后单击该文本框旁边的小方形按钮。

    相应文本将显示在按钮右侧的标签中。

请参见

任务

如何：创建事件接收器

其他资源

演练：创建带有其他内容的网站定义

开发 SharePoint 解决方案