語言

IVersioningPersonalizable.Load(IDictionary) 方法

定義

將個人化資料載入一個因版本變更而沒有對應個人化屬性的網頁零件控制項。

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 Parts 控制集會從該控制項擷取個人化資料,無論控制項為何為「髒」狀態,並在個人化生命週期後續儲存回底層資料儲存。 若在處理參數值 unknownProperties 後,控制項狀態改變,則應將自己標記為「髒」狀態。

請注意,若在匯入 Web Parts 控制項時偵測到孤立屬性,此方法會自動被呼叫。

適用於