PersonalizationProvider.LoadPersonalizationState Méthode

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Charge les données brutes du magasin de données sous-jacent et convertit ces données en un objet 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

Paramètres

webPartManager: WebPartManager

WebPartManager qui gère les données de personnalisation.

ignoreCurrentUser: Boolean

Boolean qui indique si le nom d'utilisateur doit être transmis au fournisseur de personnalisations.

Retours

PersonalizationState

PersonalizationState qui contient les données de personnalisation.

Exceptions

ArgumentNullException

webPartManager a la valeur null.

ArgumentException

La page associée à webPartManager est null.

ou - La demande associée à la page est null.

Remarques

Cette méthode est le point d’entrée principal utilisé par la WebPartPersonalization classe pour charger des données de personnalisation. L’implémentation par défaut charge les données brutes à partir du magasin de données sous-jacent (la fonctionnalité est implémentée dans les fournisseurs dérivés), puis convertit les données brutes en une PersonalizationState instance.

Si le ignoreCurrentUser paramètre a la valeur true , aucun nom d’utilisateur n’est passé à la LoadPersonalizationBlobs méthode. Un fournisseur de personnalisations peut choisir d’interpréter cela comme cela signifie que seul un état de personnalisation avec une Shared portée doit être récupéré à partir du magasin de données sous-jacent.

Quand la Load méthode s’exécute, elle appelle la LoadPersonalizationState méthode et trois types d’erreurs de désérialisation peuvent se produire lors du chargement de l’État. lorsque ces erreurs spécifiques se produisent, aucune exception n’est levée et les événements d’erreur sont enregistrés à la place par la fonctionnalité de surveillance de l’intégrité (pour plus d’informations sur la surveillance de l’intégrité et l’accès aux journaux créés par celle-ci, consultez ASP.NET vue d’ensemblede la surveillance de l’intégrité). Les trois scénarios suivants entraînent l’écriture d’événements d’erreur de désérialisation dans le journal :

Une tentative de désérialisation d’un type de propriété qui utilise une chaîne a échoué TypeConverter .
Une tentative de désérialisation d’un type de propriété qui utilise la sérialisation binaire a échoué.
Une tentative de désérialisation d’un type de propriété a échoué, car une instance du type ne peut pas être créée.

S’applique à