Partager via

WebPartPersonalization.Load Méthode

  • Référence

Définition

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

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.PersonalizationScope
Protected Overridable Function Load () As PersonalizationScope

Retours

PersonalizationScope

Instance de PersonalizationScope destinée au WebPartManager parent.

Exceptions

InvalidOperationException

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.

ProviderException

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.

ArgumentException

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.

ConfigurationErrorsException

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.

S’applique à

Voir aussi