自定义占位符控件在Windows SharePoint Services中的应用

在Windows SharePoint Services (WSS)中，自定义占位符控件（例如WssListItemsPlaceholder）能够列出几乎任何类型的WSS列表项，如文档库、图片库、公告、事件、联系人等。本文将介绍如何安装、配置和使用此类控件。

安装步骤

要将自定义占位符控件集成到SPS/WSS站点中，请按照以下步骤操作：

1. 将Web服务WSSWebs.asmx安装到SPS/WSS站点。在SPS/WSS服务器上，复制WSSWebs.asmx、WSSWebsdisco.aspx和WSSWebswsdl.aspx文件到SharePointWS目录下。

2. 将QuestechSystems.SharePointWS.dll复制到BIN目录下。

3. 将WssIntegration目录复制到MCMS站点根目录下。

4. 将Classes目录中的文件复制到MCMS站点的类目录中。

5. 将WebControls目录中的文件复制到MCMS站点的Web Controls目录中。

6. 在VS.NET中添加以下Web引用：

请注意，这些步骤仅在开发环境中执行。Web引用的URL属性将在运行时动态设置，因此可以按照常规部署方法将其部署到生产环境。

7. 编辑Classes/WssUtilities.cs文件，将第12行和第13行中的命名空间从ProjectName更改为项目名称。

8. 在MCMS模板中，插入以下样式表引用：

9. 在项目web.config文件中，添加以下appSettings键：

10. 在VS.NET中重新构建项目。

此外，请参阅MCMS文档中的"Custom Placeholder Controls"部分，它位于"Site Development: Developing Your MCMS Site: Extending the Functionality of MCMS: Creating Custom Placeholders: Custom Placeholder Controls"。

使用方法

在编辑模式下，占位符控件会显示选定的SharePoint/WSS列表的名称和位置。要选定一个SharePoint列表，请单击"Select"以启动选择SharePoint列表对话框。

首先输入站点URL。这是顶级WSS站点集合的URL，并且可以位于远程服务器上。对于SharePoint Portal Server，可能需要输入完整的顶级站点集合URL，如http:///sites/sitename。单击"Get Child Sites"以显示此站点集合下的子站点。选择一个子站点，然后选择一个列表。然后会显示一个项目预览。单击"OK"以关闭对话框。

占位符控件有两个属性：SiteCollectionUrl和SiteUrl。它们分别对应于列表选择器对话框中的"Site URL"和"Child Site"的表单值。这两个属性都是可选的，如果指定，它们将限制作者在对话框中可以选择的内容。

可以通过在web.config的appSettings键中输入类型代码来进一步限制可供选择的列表类型：QuestechSystems.WssListsToExclude。类型代码的完整列表定义在WssUtilities.cs中的ServerTemplateType。默认情况下，不支持Discussion和PortalSitesList类型的列表。由于没有测试过每种类型的WSS列表，确信还有一些类型是不支持的。

最后，可以在WssListItems.css中自定义列表项在呈现模式下的布局，或者使用自己的样式表。