PersonalizationProvider.LoadPersonalizationState Метод

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Загружает необработанные данные из базового хранилища данных и преобразует их в объект PersonalizationState.

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

Параметры

webPartManager

WebPartManager

Объект WebPartManager, управляющий данными персонализации.

ignoreCurrentUser

Boolean

Значение Boolean, показывающее, должно ли имя пользователя передаваться поставщику личной настройки.

Возвращаемое значение

PersonalizationState

Объект PersonalizationState, содержащий данные персонализации.

Исключения

ArgumentNullException

Значение параметра webPartManager — null.

ArgumentException

Страница, сопоставленная с объектом webPartManager, имеет значение null.

-или- Запрос, сопоставленный со страницей, имеет значение null.

Комментарии

Этот метод является основной точкой входа, используемой WebPartPersonalization классом для загрузки данных персонализации. Реализация по умолчанию загружает необработанные данные из базового хранилища данных (функциональность реализована в производных поставщиках), а затем преобразует необработанные данные в PersonalizationState экземпляр.

Если ignoreCurrentUser параметр имеет значение true , то в метод не передается имя пользователя LoadPersonalizationBlobs . Поставщик персонализации может интерпретировать это как то, что только состояние персонализации с Shared областью действия должно быть получено из базового хранилища данных.

При Load выполнении метода вызывается LoadPersonalizationState метод, и существуют три типа ошибок десериализации, которые могут возникнуть при загрузке состояния. при возникновении этих ошибок исключение не возникает, а события ошибок записываются функцией мониторинга работоспособности (сведения о мониторинге работоспособности и доступе к созданным им журналам см. в разделе обзор мониторинга работоспособности ASP.NET). Следующие три сценария вызывают события ошибок десериализации для записи в журнал:

• Сбой попытки десериализовать тип свойства, который использует строку TypeConverter .

• Не удалось выполнить десериализацию типа свойства, использующего двоичную сериализацию.

• Не удалось выполнить десериализацию типа свойства, так как не удается создать экземпляр типа.