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 組件控制項時偵測到孤立的屬性，就會自動呼叫這個方法。