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 管理个性化设置的高级生命周期的控件在两个个性化范围之一中执行。