PersonalizationDictionary.Add(String, PersonalizationEntry) 方法

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

向个性化设置字典添加个性化设置项。

public:
 virtual void Add(System::String ^ key, System::Web::UI::WebControls::WebParts::PersonalizationEntry ^ value);

public virtual void Add (string key, System.Web.UI.WebControls.WebParts.PersonalizationEntry value);

abstract member Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit
override this.Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit

Public Overridable Sub Add (key As String, value As PersonalizationEntry)

参数

key

String

一条状态信息的唯一标识符。

value

PersonalizationEntry

要添加到个性化设置字典中的一条状态信息。 此值可为 null。

例外

ArgumentException

key 是字典中已有的键的重复。

- 或 -

key 是一个空字符串 ("")，或者修整 key 会生成一个空字符串。

- 或 -

value 不是 PersonalizationEntry。

ArgumentNullException

key 为 null。

或

value 为 null。

注解

可以调用此方法，将各种自定义状态信息片段放入状态对象，并指定与状态值关联的范围。 当控件WebPartManager在Shared范围内时，可以添加与范围或User作用域关联的Shared名称和状态信息。 在范围中 User ，可以添加仅与 User 范围关联的名称和状态信息。

但是，无论页面范围如何，最好使用Save包含 或 Shared 范围的属性将所有属性User添加到字典。

.NET Framework 仅在适当时保存具有 Shared 作用域的属性。 换句话说，当最初添加到作用域中的控件稍后在页User处于Shared范围内时WebPart保存时，不会保存共享属性。 在相反的情况下，如果 WebPart 控件已添加到范围内的页面 User ，并且稍后在页面处于 Shared 范围内时保存该控件，则自定义共享属性值将 (与自定义用户范围属性一起保存) 。 有关个性化设置数据以及共享属性和用户范围属性如何受到页面个性化设置范围的影响的详细信息，请参阅 Web 部件个性化概述 主题。

与任何集合一样，此方法将集合计数递增 1，并且集合上当前处于活动状态的任何枚举器都应失效。

另请参阅

• Web 部件个性化概述