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 作用域的属性。 换句话说，当最初在作用域中添加的控件在页面处于WebPartShared范围内时User保存时，不会保存共享属性。 在相反的情况下，如果 WebPart 控件已添加到作用域中的 User 页面，并且该控件稍后在页面处于 Shared 范围内时保存，则会保存自定义共享属性值（以及自定义用户范围属性）。 有关个性化设置数据以及共享属性和用户范围属性受页面个性化范围影响的详细信息，请参阅 Web 部件个性化概述 主题。

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

适用于

另请参阅