PersonalizationProvider.LoadPersonalizationState Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Загружает необработанные данные из базового хранилища данных и преобразует их в объект 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, содержащий данные персонализации.
Исключения
Значение параметра webPartManager
— null
.
Страница, сопоставленная с объектом webPartManager
, имеет значение null
.
-или-
Запрос, сопоставленный со страницей, имеет значение null
.
Комментарии
Этот метод является основной точкой входа, используемой WebPartPersonalization классом для загрузки данных персонализации. Реализация по умолчанию загружает необработанные данные из базового хранилища данных (функциональность реализована в производных поставщиках), а затем преобразует необработанные данные в PersonalizationState экземпляр.
Если ignoreCurrentUser
параметр имеет значение true
, то в метод не передается имя пользователя LoadPersonalizationBlobs . Поставщик персонализации может интерпретировать это как то, что только состояние персонализации с Shared областью действия должно быть получено из базового хранилища данных.
При Load выполнении метода вызывается LoadPersonalizationState метод, и существуют три типа ошибок десериализации, которые могут возникнуть при загрузке состояния. при возникновении этих ошибок исключение не возникает, а события ошибок записываются функцией мониторинга работоспособности (сведения о мониторинге работоспособности и доступе к созданным им журналам см. в разделе обзор мониторинга работоспособности ASP.NET). Следующие три сценария вызывают события ошибок десериализации для записи в журнал:
Сбой попытки десериализовать тип свойства, который использует строку TypeConverter .
Не удалось выполнить десериализацию типа свойства, использующего двоичную сериализацию.
Не удалось выполнить десериализацию типа свойства, так как не удается создать экземпляр типа.