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ładników Web Part, która nie ma odpowiedniej 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 -> unitPublic Sub Load (unknownProperties As IDictionary)Parametry
- unknownProperties
- IDictionary
Słownik danych personalizacji, których nie można zastosować do kontrolki.
Uwagi
Parametr unknownProperties zawiera scaloną reprezentację nieznanych danych personalizacji zarówno z zakresu "Użytkownik" i "Udostępnione", którego nie można zastosować do kontrolki. Gdy strona jest uruchomiona w zakresie użytkownika, nieznane wartości zakresu użytkownika są dostarczane (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. Obowiązkiem kontrolki jest rzutowanie lub konwertowanie wartości na odpowiedni typ i przeprowadzenie dalszego przetwarzania (na przykład mapowanie danych ze starej właściwości na nową właściwość).
Jeśli stan kontrolki ulegnie zmianie, powinien wywołać SetPersonalizationDirty metodę (dziedziczona lub publiczna metoda statyczna w przypadku kontrolki, która nie pochodzi z WebPartmetody ). Jeśli kontrolka oznaczy się jako "brudna", zestaw kontrolek składników Web Part wyodrębni dane personalizacji z kontrolki, niezależnie od stanu "brudnego" kontrolki i zapisze go z powrotem do bazowego magazynu danych w dalszej części cyklu życia personalizacji. Kontrolka powinna oznaczać się jako "brudna", jeśli w wyniku przetwarzania wartości w parametrze unknownProperties stan kontrolki uległ zmianie.
Należy pamiętać, że jeśli podczas importowania kontrolek składników Web Part zostaną wykryte oddzielone właściwości, ta metoda jest wywoływana automatycznie.
