IVersioningPersonalizable.Load(IDictionary) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Carica i dati di personalizzazione in un controllo Web part che non dispone di una proprietà personalizzata corrispondente per i dati a causa di una modifica della versione.
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)Parametri
- unknownProperties
- IDictionary
Dizionario di dati di personalizzazione che non possono essere applicati a un controllo.
Commenti
Il unknownProperties parametro contiene una rappresentazione unita di dati di personalizzazione sconosciuti, sia di ambito "Utente" che "Condiviso", che non è stato possibile applicare al controllo. Quando una pagina è in esecuzione nell'ambito utente, vengono specificati i valori sconosciuti dell'ambito utente (se disponibile) anziché valori di ambito condiviso sconosciuti. Queste informazioni vengono archiviate come una serie di coppie nome/valore in cui ogni nome è il nome stringa di una proprietà non trovata nel controllo e ogni valore contiene il valore della proprietà. È responsabilità del controllo eseguire il cast o la conversione del valore nel tipo appropriato ed eseguire un'ulteriore elaborazione ,ad esempio il mapping dei dati da una proprietà precedente a una nuova proprietà.
Se lo stato di un controllo cambia, deve chiamare SetPersonalizationDirty (il metodo ereditato o il metodo statico pubblico nel caso di un controllo che non deriva da WebPart). Se un controllo si contrassegna come "dirty", il set di controlli Web part estrae i dati di personalizzazione dal controllo, indipendentemente dallo stato "dirty" del controllo e lo salva nell'archivio dati sottostante in un secondo momento nel ciclo di vita della personalizzazione. Un controllo deve contrassegnarsi come "dirty" se, in seguito all'elaborazione dei valori nel unknownProperties parametro, lo stato del controllo è cambiato.
Si noti che se vengono rilevate proprietà orfane durante l'importazione di controlli Web part, questo metodo viene chiamato automaticamente.
