PersonalizationAdministration.ResetState 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.
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 -> intPublic Shared Function ResetState (data As PersonalizationStateInfoCollection) As IntegerParâmetros
Uma coleção de objetos PersonalizationStateInfo que indica quais dados devem ser redefinidos.
Retornos
O número de linhas que foram redefinidas.
Exceções
data é null.
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.
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.
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.
