PersonalizationProvider.LoadPersonalizationState Método

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Carrega os dados brutos do armazenamento subjacente e converte esses dados num 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

A WebPartManager gestão dos dados de personalização.

ignoreCurrentUser
Boolean

A indicando Boolean se o nome de utilizador deve ser passado ao fornecedor de personalização.

Devoluções

PersonalizationState

A contendo PersonalizationState dados de personalização.

Exceções

ArgumentNullException

O webPartManager é null.

ArgumentException

A página associada a webPartManager é null.

-ou-

O pedido associado à página é null.

Observações

Este método é o principal ponto de entrada utilizado pela WebPartPersonalization classe para carregar os dados de personalização. A implementação padrão carrega os dados brutos do armazenamento subjacente (a funcionalidade é implementada em fornecedores derivados) e depois converte os dados brutos numa PersonalizationState instância.

Se o ignoreCurrentUser parâmetro for true, nenhum nome de utilizador é passado ao LoadPersonalizationBlobs método. Um fornecedor de personalização pode optar por interpretar isto como significando que apenas o estado de personalização com um Shared âmbito deve ser recuperado do armazenamento de dados subjacente.

Quando o Load método está em execução, chama-o LoadPersonalizationState , e existem três tipos de erros de desserialização que podem ocorrer à medida que o estado está a ser carregado. Quando estes erros específicos ocorrem, não é lançada nenhuma exceção, e os eventos de erro são registados pela funcionalidade de Monitorização de Saúde (para informações sobre monitorização de saúde e acesso aos registos por ela criados, veja ASP.NET Visão Geral de Monitorização de Saúde). Os seguintes três cenários fazem com que eventos de erro de desserialização sejam escritos no registo:

  • Uma tentativa falhada de desserializar um tipo de propriedade que utiliza uma cadeia TypeConverter.

  • Uma tentativa falhada de desserializar um tipo de propriedade que utiliza serialização binária.

  • Uma tentativa falhada de desserializar um tipo de propriedade porque uma instância desse tipo não pode ser criada.

Aplica-se a