IVersioningPersonalizable.Load(IDictionary) 方法

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

将个性化数据加载到一个 Web 部件控件，该控件由于版本更改而没有相应的数据个性化属性。

public:
 void Load(System::Collections::IDictionary ^ unknownProperties);

public void Load (System.Collections.IDictionary unknownProperties);

abstract member Load : System.Collections.IDictionary -> unit

Public Sub Load (unknownProperties As IDictionary)

参数

unknownProperties

IDictionary

一个无法应用于控件的个性化数据字典。

注解

参数 unknownProperties 包含无法应用于控件的“用户”和“共享”范围的未知个性化设置数据的合并表示形式。 当页面在用户范围内运行时， (提供未知的用户范围值（如果可用) ，而不是未知的共享范围值）。 此信息存储为一系列名称/值对，其中每个名称都是在控件上找不到的属性的字符串名称，每个值都包含属性值。 控件负责将值强制转换或转换为适当的类型，并执行进一步处理 (例如将数据从旧属性映射到新属性) 。

如果控件的状态发生更改，则它应调用 SetPersonalizationDirty (继承的方法，或者调用非从 WebPart) 派生的控件的公共静态方法。 如果控件将自身标记为“脏”，则 Web 部件控件集将从控件中提取个性化设置数据，而不考虑控件的“脏”状态，并在个性化生命周期的后期将其保存回基础数据存储。 如果由于处理参数中的 unknownProperties 值，控件的状态发生了更改，则控件应将自身标记为“脏”。

请注意，如果在导入 Web 部件控件时检测到孤立属性，则会自动调用此方法。