PersonalizationProvider.LoadPersonalizationState Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Ładuje nieprzetworzone dane z bazowego magazynu danych i konwertuje te dane na PersonalizationState obiekt.

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

Parametry

webPartManager

WebPartManager

Zarządzanie WebPartManager danymi personalizacji.

ignoreCurrentUser

Boolean

Element Boolean wskazujący, czy nazwa użytkownika powinna zostać przekazana do dostawcy personalizacji.

Zwraca

PersonalizationState

Zawiera PersonalizationState dane personalizacji.

Wyjątki

ArgumentNullException

Element webPartManager to null.

ArgumentException

Strona skojarzona z elementem webPartManager to null.

-lub-

Żądanie skojarzone ze stroną to null.

Uwagi

Ta metoda jest głównym punktem wejścia używanym przez klasę WebPartPersonalization do ładowania danych personalizacji. Domyślna implementacja ładuje nieprzetworzone dane z bazowego magazynu danych (funkcja jest implementowana u dostawców pochodnych), a następnie konwertuje nieprzetworzone dane na PersonalizationState wystąpienie.

ignoreCurrentUser Jeśli parametr ma truewartość , do metody nie jest przekazywana LoadPersonalizationBlobs żadna nazwa użytkownika. Dostawca personalizacji może zinterpretować to jako znaczenie, że należy pobrać tylko stan personalizacji z zakresem Shared z bazowego magazynu danych.

Load Gdy metoda jest wykonywana, wywołuje metodę LoadPersonalizationState i istnieją trzy typy błędów deserializacji, które mogą wystąpić podczas ładowania stanu. Gdy wystąpią te określone błędy, nie zostanie zgłoszony wyjątek, a zdarzenia błędów są rejestrowane zamiast funkcji monitorowania kondycji (aby uzyskać informacje na temat monitorowania kondycji i uzyskiwania dostępu do dzienników utworzonych przez nią, zobacz ASP.NET Omówienie monitorowania kondycji). Następujące trzy scenariusze powodują zapisanie zdarzeń błędu deserializacji w dzienniku:

• Nie można wykonać próby deserializacji typu właściwości, który używa ciągu TypeConverter.

• Próba deserializacji typu właściwości, który używa serializacji binarnej, nie powiodła się.

• Próba deserializacji typu właściwości nie powiodła się, ponieważ nie można utworzyć wystąpienia typu.