Поделиться через

PersonalizationProvider.DetermineInitialScope Метод

  • Ссылка

Определение

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

Определяет исходную область персонализации — Shared или User.

public:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationScope DetermineInitialScope(System::Web::UI::WebControls::WebParts::WebPartManager ^ webPartManager, System::Web::UI::WebControls::WebParts::PersonalizationState ^ loadedState);
public virtual System.Web.UI.WebControls.WebParts.PersonalizationScope DetermineInitialScope (System.Web.UI.WebControls.WebParts.WebPartManager webPartManager, System.Web.UI.WebControls.WebParts.PersonalizationState loadedState);
abstract member DetermineInitialScope : System.Web.UI.WebControls.WebParts.WebPartManager * System.Web.UI.WebControls.WebParts.PersonalizationState -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.DetermineInitialScope : System.Web.UI.WebControls.WebParts.WebPartManager * System.Web.UI.WebControls.WebParts.PersonalizationState -> System.Web.UI.WebControls.WebParts.PersonalizationScope
Public Overridable Function DetermineInitialScope (webPartManager As WebPartManager, loadedState As PersonalizationState) As PersonalizationScope

Параметры

webPartManager
WebPartManager

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

loadedState
PersonalizationState

Сведения о состоянии персонализации.

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

PersonalizationScope

Объект PersonalizationScope, указывающий текущую область персонализации — User или Shared.

Исключения

ArgumentNullException

webPartManager имеет значение null.

ArgumentException

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

Комментарии

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

Для определения область персонализации используются следующие правила:

  • Изначально предполагается, что область действия имеет значение User.

  • Если текущая учетная запись пользователя не проходит проверку подлинности, область имеет значение Shared.

  • Если выполняется проверка подлинности текущей учетной записи пользователя, дополнительная обработка выполняется в порядке приоритета:

    • Если страница находится в режиме обратной передачи, запрос страницы содержит область сведения из предыдущей отрисовки страницы. Если эта область информация указывает на Shared использование область, то область принимает значение Shared.

    • Если на выполняемой в данный момент странице был передан элемент управления с другой страницы (например, если передача управления произошла из-за вызова Transfer метода ; обратите внимание, что эта конкретная проверка не выполняется для межстраничной публикации), и если на ранее выполняющейся странице был WebPartManager экземпляр , область устанавливается значение свойства из предыдущего Personalization.ScopeWebPartManager экземпляра.

    • Если предыдущие критерии не выполняются, область вычисляется как значение InitialScope свойства для текущего WebPartManager элемента управления.

После выполнения предыдущих оценок и если область оценивается как Shared область, выполняется следующая обработка:

  • Если у текущей учетной записи пользователя есть EnterSharedScopeUserCapability возможность, область остается равным Shared.

  • Если у текущей учетной записи пользователя нет EnterSharedScopeUserCapability возможности, область сбрасывается на User.

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

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