PersonalizationProvider.LoadPersonalizationState 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.
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
Um PersonalizationState que contém os dados de personalização.
Exceções
O webPartManager
é null
.
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.