WebPartPersonalization.Load Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует персонализацию.
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.PersonalizationScopeProtected Overridable Function Load () As PersonalizationScopeВозвращаемое значение
Экземпляр PersonalizationScope для родительского объекта WebPartManager.
Исключения
Этот метод вызывается, если персонализация не включена (значение свойства Enabled равно false).
-или-
Значение свойства Page для связанного WebPartManager равно null.
-или-
Значение свойства Request для связанного экземпляра WebPartManager элемента управления the Page равно null.
Поставщик был явно задан или в разметке страницы, или в свойстве ProviderName, однако этот поставщик не может быть найден.
-или-
Объект, содержащий данные о состоянии персонализации, равен null.
При загрузке и десериализации данных произошли неполадки.
-или-
При определении поставщика персонализации в файле конфигурации произошла неполадка.
Базовые поставщики персонализации не смогли быть инициализированы, потому что не удалось найти поставщика по умолчанию или произошла неполадка при попытке инициализации поставщика персонализации.
Комментарии
Это основная точка входа для инициализации сведений о персонализации от имени родительского WebPartManager элемента управления. Этот метод вызывается во время метода родительского WebPartManagerOnInit элемента управления. Обычно, если персонализация отключена в родительском WebPartManager элементе управления, этот метод никогда не вызывается.
Во время выполнения этого метода выполняются следующие инициализации:
Получается ссылка на поставщика персонализации по умолчанию или пользовательского поставщика, указанного WebPartManager в разметке страницы или свойстве ProviderName .
Поставщик вызывается для определения возможностей пользователя (DetermineUserCapabilities) для текущего выполняющего пользователя.
Состояние персонализации для текущей комбинации страницы, пользователя и области загружается из базового хранилища данных поставщиком (LoadPersonalizationState) и сохраняется в экземпляре WebPartPersonalization .
Область персонализации для текущей страницы, пользователя или области определяется поставщиком (DetermineInitialScope). Обратите внимание, что результат этого определения может отличаться от значения InitialScope свойства .
Значение области, возвращаемое этим методом, используется в качестве значения свойства Scope .
Примечание
Исключение InvalidOperationException из-за того, что персонализация не включена, будет возникать только в Load том случае, если метод вызывается напрямую. В реализации ASP.NET для выполнения загрузки фактически вызывается внутренний вспомогательный метод, и этот вспомогательный метод автоматически возвращается, если персонализация не включена для страницы.
