WebPartPersonalization.Load 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.
Inizializza la personalizzazione.
protected:
virtual System::Web::UI::WebControls::WebParts::PersonalizationScope Load();protected virtual System.Web.UI.WebControls.WebParts.PersonalizationScope Load ();abstract member Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScopeProtected Overridable Function Load () As PersonalizationScopeRestituisce
Un'istanza PersonalizationScope per il controllo WebPartManager padre.
Eccezioni
Questo metodo viene chiamato quando la personalizzazione non è abilitata, ovvero la proprietàEnabled è impostata su false.
-oppure-
Il valore della proprietà Page per il controllo WebPartManager associato è null.
-oppure-
Il valore della proprietà Request nell'istanza WebPartManager associata del controllo Page è null.
Un provider è stato impostato in modo esplicito nel markup di pagina oppure non è stato possibile trovare la proprietà ProviderName e il provider.
-oppure-
Un oggetto contenente i dati dello stato di personalizzazione è null.
Si è verificato un problema durante il caricamento e la deserializzazione dei dati.
-oppure-
Si è verificato un errore nella definizione di un provider di personalizzazioni nel file di configurazione.
Non è stato possibile inizializzare i provider di personalizzazioni sottostanti: il provider predefinito non è stato trovato oppure si è verificato un errore durante il tentativo di inizializzazione di un provider di personalizzazioni.
Commenti
Si tratta del punto di ingresso principale per inizializzare le informazioni di personalizzazione per conto del controllo padre WebPartManager . Questo metodo viene chiamato durante il metodo del OnInit controllo padreWebPartManager. In genere, se la personalizzazione è stata disabilitata nel controllo padre WebPartManager , questo metodo non verrà mai chiamato.
Durante il corso di questo metodo, si verificano le inizialiizzazioni seguenti:
Viene ottenuto un riferimento al provider di personalizzazione predefinito o al provider personalizzato indicato nel markup della WebPartManager pagina o alla ProviderName proprietà.
Il provider viene chiamato per determinare le funzionalità utente (DetermineUserCapabilities) per l'utente attualmente in esecuzione.
Lo stato di personalizzazione per la combinazione di pagina/utente/ambito corrente viene caricato dall'archivio dati sottostante dal provider (LoadPersonalizationState) e archiviato all'interno dell'istanza WebPartPersonalization .
L'ambito di personalizzazione per la pagina/utente/ambito corrente è determinato dal provider (DetermineInitialScope). Si noti che il risultato di questa determinazione potrebbe essere diverso dal valore della InitialScope proprietà.
Il valore dell'ambito restituito da questo metodo viene usato come valore per la Scope proprietà.
Nota
Un'eccezione InvalidOperationException dovuta alla personalizzazione non abilitata si verificherà solo se il Load metodo viene chiamato direttamente. Nell'implementazione ASP.NET viene effettivamente chiamato un metodo helper interno per eseguire il carico e questo metodo helper restituisce in modo automatico se la personalizzazione non è stata abilitata per la pagina.