PersonalizationProvider.LoadPersonalizationState Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Carica i dati non elaborati dall'archivio dati sottostante e li converte in un oggetto PersonalizationState.

public:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationState ^ LoadPersonalizationState(System::Web::UI::WebControls::WebParts::WebPartManager ^ webPartManager, bool ignoreCurrentUser);

public virtual System.Web.UI.WebControls.WebParts.PersonalizationState LoadPersonalizationState (System.Web.UI.WebControls.WebParts.WebPartManager webPartManager, bool ignoreCurrentUser);

abstract member LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState
override this.LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState

Public Overridable Function LoadPersonalizationState (webPartManager As WebPartManager, ignoreCurrentUser As Boolean) As PersonalizationState

Parametri

webPartManager

WebPartManager

Oggetto WebPartManager che consente la gestione dei dati sulla personalizzazione.

ignoreCurrentUser

Boolean

Oggetto Boolean che indica se il nome utente deve essere passato al provider di personalizzazioni.

Restituisce

PersonalizationState

Un oggetto PersonalizationState che contiene i dati sulla personalizzazione.

Eccezioni

ArgumentNullException

L'elemento webPartManager è null.

ArgumentException

La pagina associata all'oggetto webPartManager è null.

-oppure-

La richiesta associata alla pagina è null.

Commenti

Questo metodo è il punto di ingresso principale usato dalla WebPartPersonalization classe per caricare i dati di personalizzazione. L'implementazione predefinita carica i dati non elaborati dall'archivio dati sottostante (la funzionalità viene implementata nei provider derivati) e quindi converte i dati non elaborati in un'istanza PersonalizationState di .

Se il ignoreCurrentUser parametro è true, al metodo non viene passato LoadPersonalizationBlobs alcun nome utente. Un provider di personalizzazione può scegliere di interpretare questo valore come significa che solo lo stato di personalizzazione con un Shared ambito deve essere recuperato dall'archivio dati sottostante.

Quando il Load metodo è in esecuzione, chiama il LoadPersonalizationState metodo e sono presenti tre tipi di errori di deserializzazione che possono verificarsi durante il caricamento dello stato. Quando si verificano questi errori specifici, non viene generata alcuna eccezione e gli eventi di errore vengono registrati invece dalla funzionalità Monitoraggio integrità (per informazioni sul monitoraggio dell'integrità e l'accesso ai log creati, vedere ASP.NET Panoramica del monitoraggio dell'integrità). I tre scenari seguenti causano la scrittura di eventi di errore di deserializzazione nel log:

• Tentativo non riuscito di deserializzare un tipo di proprietà che usa una stringa TypeConverter.

• Tentativo non riuscito di deserializzare un tipo di proprietà che utilizza la serializzazione binaria.

• Tentativo non riuscito di deserializzare un tipo di proprietà perché non è possibile creare un'istanza del tipo.