PersonalizationProvider.LoadPersonalizationState Méthode
Définition
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.PersonalizationStatePublic Overridable Function LoadPersonalizationState (webPartManager As WebPartManager, ignoreCurrentUser As Boolean) As PersonalizationStateParamè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 qui contient les données de personnalisation.
Exceptions
webPartManager a la valeur null.
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.