WebPartPersonalization.Load 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.
Initialise la personnalisation.
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 PersonalizationScopeRetours
Instance PersonalizationScope du parent WebPartManager.
Exceptions
Cette méthode est appelée lorsque la personnalisation n’est pas activée (Enabled égale false).
- ou -
La valeur de la Page propriété associée WebPartManager est null.
- ou -
La valeur de la propriété sur l’instance RequestWebPartManager associée Page du contrôle est null.
Un fournisseur a été défini explicitement dans le balisage de page ou la ProviderName propriété et le fournisseur est introuvable.
- ou -
L’objet contenant les données d’état de personnalisation est null.
Un problème s’est produit lors du chargement et de la désérialisation des données.
- ou -
Une erreur s’est produite dans la définition d’un fournisseur de personnalisation dans le fichier de configuration.
Les fournisseurs de personnalisation sous-jacents n’ont pas pu initialiser, car un fournisseur par défaut n’a pas pu être trouvé ou parce qu’un échec s’est produit lors de la tentative d’initialisation d’un fournisseur de personnalisation.
Remarques
Il s’agit du point d’entrée principal pour initialiser les informations de personnalisation pour le compte du contrôle parent WebPartManager . Cette méthode est appelée pendant la méthode du OnInit contrôle parentWebPartManager. Normalement, si la personnalisation a été désactivée sur le contrôle parent WebPartManager , cette méthode n’est jamais appelée.
Au cours de cette méthode, les initialisations suivantes se produisent :
Une référence au fournisseur de personnalisation par défaut, ou au fournisseur personnalisé indiqué dans le WebPartManager balisage de page ou la ProviderName propriété, est obtenue.
Le fournisseur est appelé pour déterminer les fonctionnalités utilisateur (DetermineUserCapabilities) pour l’utilisateur en cours d’exécution.
L’état de personnalisation de la combinaison de page/utilisateur/étendue actuelle est chargé à partir du magasin de données sous-jacent par le fournisseur (LoadPersonalizationState) et stocké dans l’instance WebPartPersonalization .
L’étendue de personnalisation de la page/utilisateur/étendue active est déterminée par le fournisseur (DetermineInitialScope). Notez que le résultat de cette détermination peut être différent de la valeur de la InitialScope propriété.
La valeur d’étendue retournée par cette méthode est utilisée comme valeur pour la Scope propriété.
Note
Une InvalidOperationException exception en raison de la personnalisation non activée se produit uniquement si la Load méthode est appelée directement. Dans l’implémentation ASP.NET, une méthode d’assistance interne est réellement appelée pour effectuer la charge, et cette méthode d’assistance retourne en mode silencieux si la personnalisation n’a pas été activée pour la page.
