PersonalizationProvider.DetermineInitialScope Método

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Determina se o escopo de personalização inicial deve ser o escopo Shared ou 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

Parâmetros

webPartManager

WebPartManager

O WebPartManager que gerencia as informações de personalização.

loadedState

PersonalizationState

As informações de estado de personalização.

Retornos

PersonalizationScope

Um PersonalizationScope que indica se o escopo de personalização atual é User ou Shared.

Exceções

ArgumentNullException

webPartManager é null.

ArgumentException

A página associada ao webPartManager é null.

Comentários

Esse método determina se o escopo atual deve ser Shared ou User, dada uma referência a um WebPartManager controle e as informações de estado de personalização que já foram carregadas anteriormente no ciclo de vida de personalização. Essas informações são usadas por uma WebPartPersonalization instância para tarefas relacionadas à personalização subsequentes.

As seguintes regras são usadas para determinar o escopo de personalização:

• O escopo é considerado inicialmente Usercomo .

• Se a conta de usuário em execução no momento não estiver autenticada, o escopo será definido Sharedcomo .

• Se a conta de usuário em execução no momento for autenticada, o processamento adicional ocorrerá em ordem de precedência:

  • Se a página estiver no modo de postback, a solicitação de página conterá informações de escopo de uma renderização anterior da página. Se essas informações de escopo indicarem que o Shared escopo foi usado, o escopo será avaliado Sharedcomo .

  • Se a página em execução no momento tiver o controle transferido para ela de outra página (por exemplo, se a transferência de controle ocorreu devido à chamada Transfer do método; observe que essa marcar específica não ocorre para postagem entre páginas) e, se a página em execução anterior tiver uma WebPartManager instância, o escopo será definido como o valor da Personalization.Scope propriedade da instância anteriorWebPartManager.

  • Se os critérios anteriores não forem atendidos, o escopo será avaliado como o valor da InitialScope propriedade do controle atual WebPartManager .

Depois que as avaliações anteriores tiverem sido feitas e se o escopo for avaliado como Shared escopo, o seguinte processamento ocorrerá:

• Se a conta de usuário em execução no momento tiver a EnterSharedScopeUserCapability funcionalidade , o escopo permanecerá definido Sharedcomo .

• Se a conta de usuário em execução no momento não tiver a EnterSharedScopeUserCapability funcionalidade , o escopo será redefinido para User.

• Se o resultado de todas as avaliações de escopo anteriores for Shared, esse resultado será armazenado como um campo oculto na página em execução no momento. Esse é o mecanismo pelo qual uma página pode reproduzir a avaliação de escopo durante postbacks subsequentes.