PersonalizationProvider.LoadPersonalizationState Método

Definição

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

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

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 gerenciamento dos 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 dado de personalização que contém.

Exceções

ArgumentNullException

O webPartManager é null.

ArgumentException

A página associada webPartManager é null.

-ou-

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

Comentários

Esse método é o principal ponto de entrada 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 converte os dados brutos em uma PersonalizationState instância.

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 significando 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 à medida que o estado está sendo carregado. Quando esses erros específicos ocorrem, nenhuma exceção é gerada e os eventos de erro são registrados no recurso Monitoramento de Integridade (para obter informações sobre monitoramento de integridade e acesso aos logs criados por ele, consulte ASP.NET Visão geral do Monitoramento de Integridade). 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