WebPartPersonalization.Load Método

Definição

Inicializa a personalização.

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

Retornos

Uma instância PersonalizationScope do WebPartManager pai.

Exceções

Este método é chamado quando a personalização não está habilitada (Enabled é igual a false).

- ou -

O valor da propriedade Page para o WebPartManager associado é null.

- ou -

O valor da propriedade Request na instância Page associada do controle WebPartManager é null.

Um provedor foi explicitamente definido na marcação da página ou a propriedade ProviderName e o provedor não puderam ser encontrados.

- ou -

O objeto que contém os dados de estado de personalização é null.

Ocorreu um problema ao carregar e desserializar os dados.

- ou -

Ocorreu um erro na definição de um provedor de personalização no arquivo de configuração.

Os provedores de personalização subjacentes não foram inicializados, porque não foi possível encontrar um provedor padrão ou porque ocorreu uma falha ao tentar inicializar um provedor de personalização.

Comentários

Esse é o ponto de entrada principal para inicializar informações de personalização em nome do controle pai WebPartManager . Esse método é chamado durante o método do OnInit controle paiWebPartManager. Normalmente, se a personalização tiver sido desabilitada no controle pai WebPartManager , esse método nunca será chamado.

Durante o curso desse método, as seguintes inicializações ocorrem:

  • Uma referência ao provedor de personalização padrão ou ao provedor personalizado indicado na marcação de WebPartManager página ou na ProviderName propriedade é obtida.

  • O provedor é chamado para determinar os recursos do usuário (DetermineUserCapabilities) para o usuário em execução no momento.

  • O estado de personalização da combinação de página/usuário/escopo atual é carregado do armazenamento de dados subjacente pelo provedor (LoadPersonalizationState) e armazenado dentro da WebPartPersonalization instância.

  • O escopo de personalização para a página/usuário/escopo atual é determinado pelo provedor (DetermineInitialScope). Observe que o resultado dessa determinação pode ser diferente do valor da InitialScope propriedade .

O valor de escopo retornado desse método é usado como o valor da Scope propriedade .

Observação

Uma InvalidOperationException exceção devido à personalização não estar habilitada ocorrerá somente se o Load método for chamado diretamente. Na implementação do ASP.NET, um método auxiliar interno é realmente chamado para executar a carga e esse método auxiliar retornará silenciosamente se a personalização não tiver sido habilitada para a página.

Aplica-se a

Confira também