Partilhar via

PersonalizationAdministration.ResetState Método

  • Referência

Definição

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

Redefine os dados de personalização no armazenamento de dados subjacente, com base nos itens contidos na coleção.

public:
 static int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ data);
public static int ResetState (System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection data);
static member ResetState : System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection -> int
Public Shared Function ResetState (data As PersonalizationStateInfoCollection) As Integer

Parâmetros

data
PersonalizationStateInfoCollection

Uma coleção de objetos PersonalizationStateInfo que indica quais dados devem ser redefinidos.

Retornos

Int32

O número de linhas que foram redefinidas.

Exceções

ArgumentNullException

data é null.

ArgumentException

data é uma coleção vazia.

- ou -

Um elemento da coleção é null.

- ou -

O valor do caminho de uma instância UserPersonalizationStateInfo na coleção é null ou uma cadeia de caracteres vazia ("").

- ou -

O valor user de uma instância UserPersonalizationStateInfo na coleção é null, uma cadeia de caracteres vazia ou contém vírgulas.

- ou -

O provedor para um provedor de personalização definido na configuração não é do tipo correto.

- ou -

O comprimento da cadeia de caracteres de qualquer parâmetro é maior do que 256 caracteres.

ConfigurationErrorsException

Ocorreu uma exceção de configuração durante a tentativa de criar e inicializar uma instância de um dos provedores de personalização configurados.

- ou -

Não foi possível encontrar o provedor de personalização padrão definido na configuração.

HttpException

O provedor padrão indicou que o número de linhas excluídas foi um número negativo.

Comentários

Esse método redefine dados de personalização no armazenamento de dados subjacente, com base nos PersonalizationStateInfo objetos contidos na coleção. Você pode usar esse método para excluir seletivamente uma combinação de dados compartilhados e por usuário com base no conteúdo da coleção. SharedPersonalizationStateInfo os objetos indicam que os dados compartilhados de uma página serão redefinidos; UserPersonalizationStateInfo os objetos indicam que os dados por usuário de uma página específica serão redefinidos.

Observação

Esse método não garante que todas as redefinições ocorram em uma única transação porque a coleção aponta para conjuntos aleatórios de dados de personalização.

Não é um erro para a coleção conter objetos que fazem referência a dados inexistentes.

Aplica-se a

Confira também