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 de PersonalizationScope destinée au WebPartManager parent.
Exceptions
Cette méthode est appelée lorsque la personnalisation n'est pas activée (Enabled correspond à une valeur false).
- ou -
La valeur de la propriété Page du contrôle WebPartManager associé est null.
- ou -
La valeur de la propriété Request de l'instance de WebPartManager associée du contrôle Page est null.
Un fournisseur, défini explicitement dans la balise de page ou dans la propriété ProviderName, est introuvable.
- ou -
L'objet qui contient 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 personnalisations dans le fichier de configuration.
L'initialisation des fournisseurs de personnalisations sous-jacents a échoué parce qu'un fournisseur par défaut est introuvable, ou parce qu'une défaillance s'est produite lors d'une tentative d'initialisation d'un fournisseur de personnalisations.
Remarques
Il s’agit du point d’entrée principal pour l’initialisation des 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) de l’utilisateur en cours d’exécution.
L’état de personnalisation de la combinaison 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/de l’utilisateur/de l’é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é .
Notes
Une InvalidOperationException exception due à une 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 en fait appelée pour effectuer le chargement, et cette méthode d’assistance retourne silencieusement si la personnalisation n’a pas été activée pour la page.
