Udostępnij za pośrednictwem

WebPartPersonalization.Load Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Inicjuje personalizację.

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

Zwraca

PersonalizationScope

Wystąpienie PersonalizationScope elementu nadrzędnego WebPartManager.

Wyjątki

InvalidOperationException

Ta metoda jest wywoływana, gdy personalizacja nie jest włączona (Enabled równa falsesię ).

-lub-

Wartość Page właściwości skojarzonej WebPartManager to null.

-lub-

Wartość Request właściwości skojarzonego WebPartManagerPage wystąpienia kontrolki to null.

ProviderException

Dostawca został jawnie ustawiony w znaczniku strony lub ProviderName właściwości i nie można odnaleźć dostawcy.

-lub-

Obiekt zawierający dane stanu personalizacji to null.

ArgumentException

Wystąpił problem podczas ładowania i deserializacji danych.

-lub-

Wystąpił błąd w definicji dostawcy personalizacji w pliku konfiguracji.

ConfigurationErrorsException

Nie można zainicjować podstawowych dostawców personalizacji, ponieważ nie można odnaleźć domyślnego dostawcy lub wystąpił błąd podczas próby zainicjowania dostawcy personalizacji.

Uwagi

Jest to główny punkt wejścia do inicjowania informacji o personalizacji w imieniu kontrolki nadrzędnej WebPartManager . Ta metoda jest wywoływana podczas metody kontrolki nadrzędnej WebPartManagerOnInit . Zwykle, jeśli personalizacja została wyłączona w kontrolce nadrzędnej WebPartManager , ta metoda nigdy nie zostanie wywołana.

W trakcie tej metody występują następujące inicjacje:

  • Uzyskuje się odwołanie do domyślnego dostawcy personalizacji lub dostawcy niestandardowego wskazanego WebPartManager w znaczniku ProviderName strony lub właściwości.

  • Dostawca jest wywoływany w celu określenia możliwości użytkownika (DetermineUserCapabilities) dla aktualnie wykonywanego użytkownika.

  • Stan personalizacji dla bieżącej kombinacji strony/użytkownika/zakresu jest ładowany z bazowego magazynu danych przez dostawcę (LoadPersonalizationState) i przechowywany w wystąpieniu WebPartPersonalization .

  • Zakres personalizacji bieżącej strony/użytkownika/zakresu jest określany przez dostawcę (DetermineInitialScope). Należy pamiętać, że wynik tej determinacji może być inny niż wartość InitialScope właściwości.

Wartość zakresu zwrócona z tej metody jest używana jako wartość właściwości Scope .

Uwaga

Wyjątek spowodowany tym, że personalizacja InvalidOperationException nie jest włączona, wystąpi tylko wtedy, gdy Load metoda jest wywoływana bezpośrednio. W implementacji ASP.NET wewnętrzna metoda pomocnika jest rzeczywiście wywoływana w celu wykonania obciążenia, a ta metoda pomocnika dyskretnie zwraca wartość, jeśli personalizacja nie została włączona dla strony.

Dotyczy

Zobacz też