WebPartPersonalization.Load Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.PersonalizationScopeProtected Overridable Function Load () As PersonalizationScopeRetornos
Uma PersonalizationScope instância para o pai WebPartManager.
Exceções
Esse método é chamado quando a personalização não está habilitada (Enabled igual a false).
- ou -
O valor da Page propriedade para o associado WebPartManager é null.
- ou -
O valor da Request propriedade na WebPartManager instância associada Page do controle é null.
Um provedor foi definido explicitamente na marcação da página ou na ProviderName propriedade e o provedor não pôde ser encontrado.
- ou -
O objeto que contém os dados de estado de personalização é null.
Ocorreu um problema ao carregar e desserializar dados.
- ou -
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 um provedor padrão não pôde ser encontrado ou porque ocorreu uma falha ao tentar inicializar um provedor de personalização.
Comentários
Esse é o principal ponto de entrada 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 deste 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 da 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 retorna silenciosamente se a personalização não foi habilitada para a página.
