WebPart.SaveProperties 属性
获取或设置一个值,指示 Web 部件的属性是否已更改,并应保持页呈现的末尾。
命名空间: Microsoft.SharePoint.WebPartPages
程序集: Microsoft.SharePoint(位于 Microsoft.SharePoint.dll 中)
语法
声明
Protected Friend Property SaveProperties As Boolean
Get
Set
用法
Dim value As Boolean
value = Me.SaveProperties
Me.SaveProperties = value
protected internal bool SaveProperties { get; set; }
属性值
类型:System.Boolean
true如果应保留 Web 部件属性。否则为false。
备注
SaveProperties属性最初设置为false页呈现的开头。该属性仅在页面呈现很有用。例如,此属性的效果不通过对象模型访问 Web 部件时。
SaveProperties属性可以用于 Web 部件时在 Web 部件页呈现后更改其属性。属性更改后, WebPart类可以设置为true指定将保存任何已更改的属性的SaveProperties属性。Web 部件的System.Web.UI.Control.UnLoad事件发生后,读取SaveProperties属性的值由 Web 部件基础结构、 在哪一点所有属性值的查询和 SharePoint 数据库中存储。如果未设置此属性,属性将还原为其原始值的下次实例化 Web 部件。
除非主动呈现 Web 部件,则忽略SaveProperties属性的值。例如,实例化一个新的 Web 部件,属性值,然后设置SaveProperties改为true不起作用。SaveProperties属性应使用 Web 部件需要保存呈现后已更改的属性。如果外部设置属性,则对上述任何一个外部代理的责任显式,或将SaveProperties属性设置代表 Web 部件呈现周期期间保存 Web 部件。
如果SaveProperties属性设置在静态的 Web 部件 (Web 部件中没有位于区域),或用户没有足够的权限,以保存更改 (例如匿名用户) 的 Web 部件,当尝试保存该 Web 部件将引发异常。Web 部件应显示用户界面将保存属性值,并将SaveProperties设置为true之前检查Permissions属性。
若要查看的代码示例,提供有关如何使用SaveProperties属性的示例,请参阅WebPart。