WebPartPersonalization.Load Метод

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

Инициализирует персонализацию.

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

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

PersonalizationScope

Экземпляр PersonalizationScope для родительского объекта WebPartManager.

Исключения

InvalidOperationException

Этот метод вызывается, если персонализация не включена (значение свойства Enabled равно false).

-или-

Значение свойства Page для связанного WebPartManager равно null.

-или-

Значение свойства Request для связанного экземпляра WebPartManager элемента управления the Page равно null.

ProviderException

Поставщик был явно задан или в разметке страницы, или в свойстве ProviderName, однако этот поставщик не может быть найден.

-или-

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

ArgumentException

При загрузке и десериализации данных произошли неполадки.

-или-

При определении поставщика персонализации в файле конфигурации произошла неполадка.

ConfigurationErrorsException

Базовые поставщики персонализации не смогли быть инициализированы, потому что не удалось найти поставщика по умолчанию или произошла неполадка при попытке инициализации поставщика персонализации.

Комментарии

Это основная точка входа для инициализации сведений о персонализации от имени родительского WebPartManager элемента управления. Этот метод вызывается во время метода родительского WebPartManagerOnInit элемента управления. Обычно, если персонализация отключена в родительском WebPartManager элементе управления, этот метод никогда не вызывается.

Во время выполнения этого метода выполняются следующие инициализации:

  • Получена ссылка на поставщика персонализации по умолчанию или пользовательского поставщика, указанного WebPartManager в разметке страницы или свойстве ProviderName .

  • Поставщик вызывается для определения возможностей пользователя (DetermineUserCapabilities) для текущего выполняющего пользователя.

  • Состояние персонализации для текущей комбинации страницы, пользователя и области загружается из базового хранилища данных поставщиком (LoadPersonalizationState) и сохраняется в экземпляре WebPartPersonalization .

  • Область персонализации для текущей страницы, пользователя или области определяется поставщиком (DetermineInitialScope). Обратите внимание, что результат этого определения может отличаться от значения InitialScope свойства .

Значение области, возвращаемое этим методом, используется в качестве значения свойства Scope .

Примечание

Исключение InvalidOperationException из-за того, что персонализация не включена, будет возникать только в Load том случае, если метод вызывается напрямую. В реализации ASP.NET для выполнения загрузки фактически вызывается внутренний вспомогательный метод, и этот вспомогательный метод автоматически возвращается, если персонализация не включена для страницы.

Применяется к

См. также раздел