WebPartPersonalization.Load Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 PersonalizationScopeDevoluções
Uma PersonalizationScope instância para o progenitor WebPartManager.
Exceções
Este método é chamado quando a personalização não está ativada (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 ao controlo é null.
Um fornecedor estava explicitamente definido na marcação da página ou na ProviderName propriedade e o fornecedor não podia ser encontrado.
-ou-
O objeto que contém os dados do estado de personalização é null.
Ocorreu um problema durante o carregamento e desserialização dos dados.
-ou-
Ocorreu um erro na definição de um fornecedor de personalização no ficheiro de configuração.
Os fornecedores de personalização subjacentes falharam em inicializar porque um fornecedor padrão não foi encontrado ou porque ocorreu uma falha ao tentar inicializar um fornecedor de personalização.
Observações
Este é o principal ponto de entrada para inicializar a informação de personalização em nome do controlo principal WebPartManager . Este método é chamado durante o método do OnInit controlo do paiWebPartManager. Normalmente, se a personalização estiver desativada no controlo parental WebPartManager , este método nunca será chamado.
Durante este método, ocorrem as seguintes inicializações:
Obtém-se uma referência ao fornecedor de personalização padrão, ou ao fornecedor personalizado indicado na WebPartManager marcação de página ou na ProviderName propriedade.
O fornecedor é chamado para determinar as capacidades do utilizador (DetermineUserCapabilities) para o utilizador que está a executar.
O estado de personalização para a combinação atual de página/utilizador/âmbito é carregado a partir do armazenamento de dados subjacente pelo fornecedor (LoadPersonalizationState) e armazenado dentro da WebPartPersonalization instância.
O âmbito de personalização para a página/utilizador/âmbito atual é determinado pelo fornecedor (DetermineInitialScope). Note-se que o resultado desta determinação pode ser diferente do valor do InitialScope imóvel.
O valor de âmbito devolvido deste método é usado como valor da Scope propriedade.
Note
Uma InvalidOperationException exceção devido à personalização não estar ativada só ocorrerá se o Load método for chamado diretamente. Na implementação do ASP.NET, é chamado um método helper interno para realizar o load, e este método helper retorna silenciosamente se a personalização não estiver ativada para a página.