PersonalizationProvider.LoadPersonalizationState Método

Referência

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

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.

Carrega os dados brutos do armazenamento de dados subjacente e converte esses dados em um objeto PersonalizationState.

public:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationState ^ LoadPersonalizationState(System::Web::UI::WebControls::WebParts::WebPartManager ^ webPartManager, bool ignoreCurrentUser);

public virtual System.Web.UI.WebControls.WebParts.PersonalizationState LoadPersonalizationState (System.Web.UI.WebControls.WebParts.WebPartManager webPartManager, bool ignoreCurrentUser);

abstract member LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState
override this.LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState

Public Overridable Function LoadPersonalizationState (webPartManager As WebPartManager, ignoreCurrentUser As Boolean) As PersonalizationState

Parâmetros

webPartManager: WebPartManager

O WebPartManager que gerencia os dados de personalização.

ignoreCurrentUser: Boolean

Um Boolean que indica se o nome de usuário deve ser passado para o provedor de personalização.

Retornos

PersonalizationState

Um PersonalizationState que contém os dados de personalização.

Exceções

ArgumentNullException

O webPartManager é null.

ArgumentException

A página associada ao webPartManager é null.

- ou - A solicitação associada à página é null.

Comentários

Esse método é o ponto de entrada principal usado pela WebPartPersonalization classe para carregar dados de personalização. A implementação padrão carrega os dados brutos do armazenamento de dados subjacente (a funcionalidade é implementada em provedores derivados) e, em seguida, converte os dados brutos em uma PersonalizationState instância do.

Se o ignoreCurrentUser parâmetro for true , nenhum nome de usuário será passado para o LoadPersonalizationBlobs método. Um provedor de personalização pode optar por interpretar isso como o que significa que somente o estado de personalização com um Shared escopo deve ser recuperado do armazenamento de dados subjacente.

Quando o Load método está em execução, ele chama o LoadPersonalizationState método e há três tipos de erros de desserialização que podem ocorrer enquanto o estado está sendo carregado. quando ocorrem esses erros específicos, nenhuma exceção é lançada e os eventos de erro são registrados em vez do recurso de monitoramento de integridade (para obter informações sobre monitoramento de integridade e acesso aos logs criados por ele, consulte visão geral do monitoramento de integridade ASP.NET). Os três cenários a seguir fazem com que os eventos de erro de desserialização sejam gravados no log:

Uma tentativa com falha de desserializar um tipo de propriedade que usa uma cadeia de caracteres TypeConverter .
Uma tentativa com falha de desserializar um tipo de propriedade que usa serialização binária.
Uma tentativa com falha de desserializar um tipo de propriedade porque uma instância do tipo não pode ser criada.

Aplica-se a

Partilhar via