PersonalizationScope 枚举

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

指示 WebPartManager 对象的个性化设置范围或应用于 Web 部件控件上的属性的个性化设置范围。

public enum class PersonalizationScope

public enum PersonalizationScope

type PersonalizationScope = 

Public Enum PersonalizationScope

继承

Object

ValueType

Enum

PersonalizationScope

字段

Shared	1	当引用 WebPartManager 控件上的范围时，Shared 范围是指应用于页面上所有可个性化设置控件的全部用户并可保存在该页面上的个性化设置数据。 引用与 Web 部件控件属性关联的作用域时，Shared 作用域表示，属性通常只允许加载或保存与所有用户关联的数据。
User	0	当涉及 WebPartManager 控件上的范围时，User 范围意味着，对于页面上的所有可个性化设置控件，特定于用户的个性化数据以及适用于所有用户的个性化数据都会被加载。 只有特定于用户的个性化设置数据可以保存在页面上。 引用与 Web 部件控件属性关联的作用域时，User 作用域表示，属性仅在 Shared 作用域内的页面上运行时，才能加载和存储适用于所有用户的数据。 但是，当属性的控件在 User 范围内的页面上运行时，将加载并合并该属性的每个用户和所有用户数据。 但是，在这种情况下，当页面在作用域内 User 运行时，只会保存每用户数据。

示例

以下示例演示如何使用 PersonalizationScope 枚举：

if (_manager.Personalization.Scope == PersonalizationScope.Shared)
{
    TextBox2.Text = "Shared Scope";
}
else
    TextBox2.Text = "User Scope";

注解

个性化设置范围是 Web 部件个性化设置中的一个关键概念，与其他设置紧密集成，包括页面通过 WebPartManager 控件运行的范围、与控件上每个属性关联的范围以及控件添加到页面的方式。 有关个性化设置范围的详细信息，请参阅 Web 部件个性化概述。

个性化设置范围是指个性化设置数据如何适用于不同的用户组。 某些个性化设置数据仅适用于页面上的特定用户和控件。 其他个性化设置数据适用于查看网站的所有用户。 个性化设置范围用于个性化设置的各个方面，以指示应检索和显示哪组数据。

当页面在 Shared 个性化设置范围内运行时，这表示应仅加载特定控件的个性化设置数据（适用于所有查看该控件的用户）。 根据当前执行用户的权限，还可以修改这些广泛适用的数据并将其保存回数据存储。 当页面在 User 个性化设置范围内运行时，这表示应根据当前正在执行的用户保存和加载控件的个性化设置数据。 通常，这意味着可以在控件上加载和保存特定于用户的数据，而广泛适用的数据 (或共享数据) 只能在控件上查看。

WebPartManager管理个性化设置的高级生命周期的控件在两个个性化设置范围之一中执行。