IVersioningPersonalizable.Load(IDictionary) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Ładuje dane personalizacji do kontrolki składniki Web Part, która nie ma odpowiadającej im spersonalizowanej właściwości danych z powodu zmiany wersji.
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)
Parametry
- unknownProperties
- IDictionary
Słownik danych personalizacji, których nie można było zastosować do kontrolki.
Uwagi
Parametr zawiera scaloną reprezentację nieznanych danych personalizacji z zakresu "Użytkownik" i "Udostępnione", których nie można było zastosować unknownProperties
do kontrolki. Gdy strona jest uruchomiona w zakresie użytkownika, są dostarczane nieznane wartości zakresu użytkownika (jeśli są dostępne), a nie nieznane wartości zakresu udostępnionego. Te informacje są przechowywane jako seria par nazwa/wartość, w których każda nazwa jest nazwą ciągu właściwości, która nie została znaleziona w kontrolce, a każda wartość zawiera wartość właściwości. Kontrolka jest odpowiedzialna za rzutowanie lub przekonwertowanie wartości na odpowiedni typ i przeprowadzenie dalszego przetwarzania (takiego jak mapowanie danych ze starej właściwości na nową właściwość).
Jeśli stan kontrolki zmieni się, powinna ona wywołać metodę (odziedziczone metody lub publiczną metodę statyczną w przypadku kontrolki, która nie pochodzi SetPersonalizationDirty od WebPart klasy ). Jeśli kontrolka oznacza się jako "zanieczyszczona", zestaw kontrolek składniki Web Part wyodrębni dane personalizacji z kontrolki, niezależnie od stanu "zanieczyszczonego" kontrolki, i zapisze je z powrotem w bazowym magazynie danych w dalszej części cyklu życia personalizacji. Kontrolka powinna oznaczać się jako "zanieczyszczona", jeśli w wyniku przetwarzania wartości w parametrze stan kontrolki unknownProperties
uległ zmianie.
Należy pamiętać, że jeśli właściwości oddzielone zostaną wykryte podczas importowania składniki Web Part, ta metoda jest wywoływana automatycznie.