Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método PersonalizationProvider.ResetState

Quando substituído em uma classe derivada, exclui o estado de personalização do armazenamento de dados subjacente com base nos parâmetros especificados.

Namespace:  System.Web.UI.WebControls.WebParts
Assembly:  System.Web (em System.Web.dll)

public abstract int ResetState(
	PersonalizationScope scope,
	string[] paths,
	string[] usernames
)

Parâmetros

scope
Tipo: System.Web.UI.WebControls.WebParts.PersonalizationScope
A PersonalizationScope as informações de personalização sejam redefinidas. Esse valor não pode ser null.
paths
Tipo: System.String[]
Os caminhos para as informações de personalização a ser excluído.
usernames
Tipo: System.String[]
Os nomes de usuário para obter informações de personalização a ser excluído.

Valor de retorno

Tipo: System.Int32
O número de linhas excluídas.

Esse método é a definição abstrata de um método administrativo para excluir dados de personalização. Derivados de implementações devem seguir a lógica descrita abaixo.

Nenhuma pesquisa de caractere curinga é suportada por esse método. Se o provedor de personalização expõe dados de um armazenamento de dados de transaction-aware, este método deve executar suas operações como uma única transação atômica.

São permitidas apenas as combinações de parâmetros a seguir:

  • O scope parâmetro for definido, e todos os outros parâmetros são definidos como null. Essa combinação exclui todos os dados de personalização de Web Parts associados com o escopo de personalização, indicado por scope.

  • O scope parâmetro for definido e o paths parâmetro contém pelo menos um valor. Essa combinação exclui todos os dados de personalização de Web Parts para o caminho especificado ou caminhos no escopo de personalização, indicado por scope.

  • O scope parâmetro for definido como User, o paths parâmetro é definido e contém apenas um valor e o usernames parâmetro contém pelo menos um valor. Essa combinação exclui a personalização de usuário de todos os dados de Web Parts para o caminho específico que está associado com o usuário ou usuários que estão contidos no usernames.

  • O scope parâmetro for definido como User, o paths parâmetro for definido como nulle o usernames parâmetro contém pelo menos um valor. Essa combinação exclui a personalização de cada usuário todos os dados de Web Parts, em todos os caminhos, associados com o usuário ou usuários que estão contidos no usernames.

Qualquer outra combinação de valores de parâmetro é inválida e lança um ArgumentException exceção. Especificamente, as seguintes combinações de dois não são permitidas:

  • O usernames parâmetro não pode ser fornecido quando scope for definido como Shared.

  • O paths parâmetro não pode conter mais de uma entrada quando a usernames parâmetro não é null.

Qualquer paths e usernames os valores de parâmetro contidos respectivas matrizes devem atender as seguintes regras de validação. Se nenhuma regra de validação falhar por qualquer membro da matriz de parâmetros, um ArgumentException exceção é lançada. As regras de validação são:

  • null valores não são permitidos.

  • Uma seqüência vazia ("") não é permitido. Parâmetros devem ser eliminados antes de executar uma verificação de seqüência de caracteres vazia.

  • O usernames parâmetro não pode conter vírgulas (,).

  • O comprimento da paths parâmetro não pode ser maior que 256 caracteres para um banco de dados SQL.

  • O comprimento da usernames parâmetro não pode ser maior que 256 caracteres para um banco de dados SQL.

.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft