PersonalizationProvider.LoadPersonalizationState Méthode

Définition

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

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

Gestion WebPartManager des données de personnalisation.

ignoreCurrentUser
Boolean

Indiquant Boolean si le nom d’utilisateur doit être transmis au fournisseur de personnalisation.

Retours

PersonalizationState

Contenant PersonalizationState des 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 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 est true, aucun nom d’utilisateur n’est passé à la LoadPersonalizationBlobs méthode. Un fournisseur de personnalisation peut choisir d’interpréter cela comme signifiant que seul l’état de personnalisation avec une Shared étendue doit être récupéré à partir du magasin de données sous-jacent.

Lorsque la Load méthode est en cours d’exécution, elle appelle la LoadPersonalizationState méthode et il existe trois types d’erreurs de désérialisation qui peuvent se produire lorsque l’état est chargé. Lorsque ces erreurs spécifiques se produisent, aucune exception n’est levée et les événements d’erreur sont consignés à la place par la fonctionnalité 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 celui-ci, consultez ASP.NET Vue d’ensemble de 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 :

  • Échec de la tentative de désérialisation d’un type de propriété qui utilise une chaîne TypeConverter.

  • Échec de la tentative de désérialisation d’un type de propriété qui utilise la sérialisation binaire.

  • Échec de la tentative de désérialisation d’un type de propriété, car une instance du type ne peut pas être créée.

S’applique à