IVersioningPersonalizable.Load(IDictionary) Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Carica i dati di personalizzazione in un controllo Web part che non ha 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 -> unit

Public Sub Load (unknownProperties As IDictionary)

Parametri

unknownProperties

IDictionary

Non è stato possibile applicare un dizionario di dati di personalizzazione a un controllo.

Commenti

Il unknownProperties parametro contiene una rappresentazione unita dei 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, i valori dell'ambito utente sconosciuti vengono forniti (se disponibili) 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 convertire il valore nel tipo appropriato ed eseguire ulteriori elaborazioni, 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 "sporco", il set di controlli Web part estrae i dati di personalizzazione dal controllo, indipendentemente dallo stato "sporco" del controllo e lo salva nell'archivio dati sottostante più avanti nel ciclo di vita della personalizzazione. Un controllo deve contrassegnarsi come "sporco" se, in seguito all'elaborazione dei valori nel unknownProperties parametro, lo stato del controllo è cambiato.

Si noti che se le proprietà orfane vengono rilevate quando si importano controlli Web part, questo metodo viene chiamato automaticamente.