构建SharePoint网站时要注意的强大控件

我一直想做的事情是讨论一些我发现在将SharePoint网站组合在一起时有用的控件。显然，在为特定行为构建自定义控件之前，最好检查一下SharePoint是否附带有任何可以完成这项工作的东西。有时您会发现惊讶！当然，那些来自Content Management Server背景的人会熟悉在团队中拥有许多可重用控件（使用CMS API）的想法，但是在MOSS中，一些等效控件是免费提供的。最明显的是Content by Query Web部件（尽管我们不会提到如果没有额外的工作就无法访问输出HTML [符合WCAG AA]），但是一些较小的控件也需要引起注意。因此，以下是该工具箱中一些方便的项目：

SPSecurityTrimmedControl

此控件可用于有选择地显示内容或控件，具体取决于当前用户的SharePoint权限。因此，如果用户没有指定的权限，则不会显示控件的内部内容。一个例子是：

   1: <SharepointWebControls:SPSecurityTrimmedControl runat="server"  权限 ="ManageWeb">

   2:     This is only visible to users who can manage current web..    

   3: </SharepointWebControls:SPSecurityTrimmedControl> 

除了 权限 上面显示的属性（枚举）， 权限 String 属性可用于指定逗号分隔 清单 所需的权限。可以与 权限模式 需要的财产 '所有' 要么 '任何' ，以及PermissionContext属性，该属性指定了指定权限适用于哪些SharePoint对象（例如'CurrentList'，'CurrentFolder'，'CurrentItem'，'CurrentSite'，'RootSite'），因此非常灵活。可以指定的权限示例 包括“ ManageLists”，“ AddListItems”，“ ViewPages”，“ ManagePermissions”和 以此类推。这些是 SPBasePermission 枚举和 Zac Smith有完整列表。值得注意的是，其中的许多权限在协作方案中可能比WCM更有用。 [UPDATE: 文本 in this section updated following comment below/further testing:] 对于WCM人士而言，该控件的确看起来像在对身份验证类型进行过滤方面有所帮助-不幸的是，此方法无法像宣传的那样起作用。供参考（如果MS对其进行了修复），用法是：

   1: <SharepointWebControls:SPSecurityTrimmedControl runat="server" AuthenticationRestrictions="AnonymousUsersOnly">

   2:     This *should* be visible only to anonymous users but it doesn't work..    

   3: </SharepointWebControls:SPSecurityTrimmedControl> 

如您所料，此处的有效值为“ 匿名 UsersOnly”，“ AuthenticatedUsersOnly”和“ AllUsers”-但是，如下面的注释中所述，“ AuthenticatedUsersOnly”是唯一看起来正常工作的标志。

还有其他一些有趣的属性：

• PagesMode-有效选项为“设计”，“全部”和“正常”


• QueryStringParametersToInclude


• 必需功能

这些 看 例如需要过滤的其他属性，但是我也无法使它们起作用。我的调查能力让我失望了，因为将Reflector触发到SPSecurityTrimmedControl和相关的RightsSensitiveVisibilityHelper类上并没有带来任何用处，Google或搜索这12个配置单元也没有。当然，看起来值是后两个参数所需的全部，但我并不高兴。但是，对SPSecurityTrimmedControl的最后考虑是通过以与SPLinkBut​​ton相同的方式从此控件派生而打开更多可能性的想法。

EditModePanel

在先前的控件检查用户的权限以确定是否应显示内容的位置上，EditModePanel会查看当前页面是处于显示模式还是编辑模式。在WCM世界中，当用户编辑页面时向用户显示帮助消息或其他内容时，这可能非常有用。但是，还有其他用途-隐藏导航，添加内联CSS覆盖类以使用不同的格式（特别有用）以及在HTML输出中发出调试信息都是示例。该控件的声明如下所示：

   1: <PublishingWebControls:EditModePanel SuppressTag="false" GroupingText="Title help" 

   2:         PageDisplayMode="Edit" runat="server" id="EditModePanel1">

   3:     Page 标题s should be concise

   4: </PublishingWebControls:EditModePanel>

在编辑模式下运行时，它看起来像：

更漂亮的用法可能是将字段控件包含在每个各自的EditModelPanel中，这意味着输入控件显示在框的边框内。为此，我们还需要将额外的EditModePanel设置为PageMode = "Display"由于原件将仅在编辑模式下显示，因此该控件还包含字段控件。注意此控件将输出一个周围<div>除非SuppressTag属性设置为“ True”。

ListItemProperty

您可以与以前的控件一起使用的一个控件是ListItemProperty控件。这个简单的小家伙可以让您为列表项写出特定字段的值。呈现的字段是通过Property属性指定的，我们在其中指定字段的内部名称。默认情况下，使用当前列表项（即用于我们正在查看的页面），但是可以通过指定List属性来覆盖它-为此，我们使用大括号指定列表GUID：

   1: < 的SharePoint WebControls:ListItemProperty runat="server" id="ListItemProperty1" 

   2:     List="{C110296D-2BE9-4818-80EE-A06BD018DE2F}" ListItemID="1" Property="Title"/>

我认为此控件是对所选字段的内容执行.ToString（）。在WCM中，有时您希望此值显示在页面上与编辑值不同的位置（例如，在<title>标签。请注意，我们还可以指定 版 我们要使用ListItemVersion属性检索其值的列表项。

ListProperty

与ListItemProperty几乎相同，除了列表本身。这两个很可能一起使用，就像列表中DispForm.aspx中的代码一样：

   1: < 的SharePoint :ListProperty Property="LinkTitle" runat="server" id="ID_LinkTitle"/>

   2: : 

   3: < 的SharePoint :ListItemProperty id="ID_ItemProperty" MaxLength="40" runat="server"/>

This will show the current 清单 's 标题, followed by a colon, followed by the current 清单 item's 标题.

项目属性

名称有些混乱，但是此控件使我们可以写出当前站点/网站的某些属性。的 MSDN文档 显示有效列表为：

• BlogCategoryTitle-当前帖子项目的类别


• BlogPostTitle-当前帖子项目的标题


• 描述-当前网站的描述


• RecycleBinEnabled-如果启用了回收站，则为1；否则为0。否则为0


• SiteOwnerName-当前网站集的所有者的用户名


• SiteUrl-当前网站集的完整URL


• 标题-当前网站的标题


• 网址-当前网站的完整URL

So the following would write out the 标题 of the current web:

   1: < 的SharePoint WebControls:ProjectProperty runat="server" id=" 项目属性 1" 

   2:     Property="Title" />

委托控制

此控件提供了一种体系结构，其中在页面布局/母版页上添加了“外部”控件，但“内部”控件由功能部件确定，因此可以换出该控件，而无需修改原始模板。这在Microsoft的母版页中得到广泛使用。这是一个很好的控件，我将在后面更全面地讨论 使用DelegateControl 发布。

AssetUrlSelector

为了完成一些稍有不同的操作，在开发自定义Web部件和现场控件时，此控件非常有用。它提供了使用SharePoint时作者习惯的“文件选择器”体验，并且在您具有需要选择文件的控件时非常适合。因此，在我的几个控件中，我允许用户覆盖用于格式化的XSL文件，并将AssetUrlSelector添加到我用于控件的编辑视图的用户控件中。这为我提供了“浏览”按钮，单击该按钮将启动选择器：

 
单击该按钮，然后显示：

 
AssetUrlSelector 提供了相当不错的用户体验，包括在当前选定文件的位置（如果存在）打开选择器，或者如果不存在则默认为指定的默认位置。同样，如果您需要提供平滑的体验来选择图像，则可以使用RichImageSelector-这是RichImageField控件使用的选择器。

概要

这就是我发现有用的一些控件。显然还有更多的堆栈，我强调过的堆栈可以用很多有趣的方式使用，这里不再讨论。但是希望这确实可以提醒您在花时间编写自己的东西之前先检查一下盒子中的内容！