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 ，可以添加与 Shared 作用域或作用域相关联的名称和状态信息 User 。 在 User "作用域" 中，可以添加仅与作用域相关联的名称和状态信息 User 。

但这是一个很好的做法，即，使用包含或范围的属性将所有属性添加到字典 Save User Shared 中，而不考虑页面的作用域。

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

与任何集合一样，此方法将集合计数递增1，且集合上当前活动的所有枚举数都应失效。

另请参阅

• Web 部件个性化概述