SqlPersonalizationProvider.ResetState Método

Definição

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

Elimina a informação de estado de personalização do armazenamento de dados subjacente, com base nos parâmetros especificados.

public:
 override int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, cli::array <System::String ^> ^ paths, cli::array <System::String ^> ^ usernames);
public override int ResetState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, string[] paths, string[] usernames);
override this.ResetState : System.Web.UI.WebControls.WebParts.PersonalizationScope * string[] * string[] -> int
Public Overrides Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As Integer

Parâmetros

scope
PersonalizationScope

A indica PersonalizationScope a informação de personalização a ser consultada. Este valor não pode ser null.

paths
String[]

Os caminhos para a informação de personalização no Shared âmbito serão eliminados.

usernames
String[]

Os nomes de utilizador para a informação de personalização no User âmbito a serem eliminados.

Devoluções

Int32

O número de linhas apagadas.

Exceções

ArgumentException

Ou o paths ou o usernames parâmetro é um array vazio.

-ou-

Os paths parâmetros e usernames contidos nos respetivos arrays não cumprem as regras de validação.

ArgumentOutOfRangeException

O scope especificado não é membro da PersonalizationScope enumeração.

Observações

Nenhum personagem coringa é suportado por este método.

Apenas as seguintes combinações de parâmetros são permitidas:

  • O scope parâmetro é definido, e todos os outros parâmetros são definidos para null. Esta combinação elimina todos os dados de personalização das Web Parts associados ao âmbito de personalização indicado por scope.

  • O scope parâmetro está definido, e o paths parâmetro contém pelo menos um valor. Esta combinação elimina todos os dados de personalização de Web Parts para o caminho especificado ou caminhos que estejam no âmbito de personalização indicado por scope.

  • O scope parâmetro é definido para User, o paths parâmetro está definido e contém apenas um caminho, e o usernames parâmetro contém pelo menos um valor. Esta combinação elimina todos os dados de Web Parts de personalização do utilizador para o caminho dado que estão associados ao utilizador ou utilizadores contidos em usernames.

  • O scope parâmetro é definido para User, o paths parâmetro é null, e o usernames parâmetro contém pelo menos um valor. Esta combinação elimina todos os dados de Web Parts de personalização por utilizador, em todos os caminhos, associados ao utilizador ou utilizadores contidos em usernames.

Qualquer outra combinação de valores de parâmetros é inválida e gera uma ArgumentException exceção. Por exemplo, as seguintes duas combinações não são permitidas:

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

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

Os paths parâmetros e usernames contidos nos respetivos arrays devem cumprir as seguintes regras de validação. Se alguma regra de validação falhar para qualquer membro dos arrays de parâmetros, é lançada uma ArgumentException exceção. As regras de validação incluem:

  • null Valores não são permitidos.

  • Uma corda vazia ("") depois de a corda ter sido aparada não é permitida.

  • Nenhum nome de utilizador contido no usernames parâmetro pode conter vírgulas.

  • O comprimento de qualquer caminho no paths parâmetro não pode ser superior a 256 caracteres.

  • O comprimento de qualquer nome de utilizador no usernames parâmetro não pode ser superior a 256 caracteres.

Aplica-se a