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
PersonalizationScope Istanza di per l'oggetto padreWebPartManager.
Eccezioni
Questo metodo viene chiamato quando la personalizzazione non è abilitata (Enabled uguale a false).
oppure
Il valore della Page proprietà per l'oggetto associato WebPartManager è null.
oppure
Il valore della Request proprietà WebPartManager nell'istanza associata Page del controllo è null.
Un provider è stato impostato in modo esplicito nel markup della pagina o nella ProviderName proprietà e il provider non è stato trovato.
oppure
L'oggetto contenente i dati sullo 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 personalizzazione nel file di configurazione.
Impossibile inizializzare i provider di personalizzazione sottostanti perché non è stato possibile trovare un provider predefinito o perché si è verificato un errore durante il tentativo di inizializzare un provider di personalizzazione.
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 inizializzazioni seguenti:
Viene ottenuto un riferimento al provider di personalizzazione predefinito o al provider personalizzato indicato nel WebPartManager markup della 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 di ambito restituito da questo metodo viene utilizzato come valore per la Scope proprietà .
Annotazioni
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 caricamento e questo metodo helper restituisce automaticamente se la personalizzazione non è stata abilitata per la pagina.
