PersonalizationProvider.ResetState Método

Definição

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

Quando sobreposto numa classe derivada, elimina o estado de personalização do armazenamento de dados subjacente com base nos parâmetros especificados.

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

Parâmetros

scope
PersonalizationScope

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

paths
String[]

Os caminhos para a informação de personalização serem eliminados.

usernames
String[]

Os nomes de utilizador para a informação de personalização devem ser eliminados.

Devoluções

Int32

O número de linhas apagadas.

Observações

Este método é a definição abstrata de um método administrativo para eliminar dados de personalização. As implementações derivadas devem seguir a lógica descrita abaixo.

Este método não suporta pesquisas de caracteres coringa. Se o fornecedor de personalização expor dados de um armazenamento de dados consciente da transação, este método deverá realizar as suas operações como uma única transação atómica.

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 das Web Parts para o caminho ou caminhos especificados no âmbito de personalização indicado por scope.

  • O scope parâmetro é definido para User, o paths parâmetro é definido e contém apenas um valor, 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 é definido para 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. Especificamente, as seguintes duas combinações não são permitidas:

  • O usernames parâmetro não pode ser fornecido quando scope 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é .

Quaisquer paths valores de parâmetro 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 são:

  • null Valores não são permitidos.

  • Uma corda vazia ("") não é permitida. Os parâmetros devem ser cortados antes de realizar uma verificação de cordas vazias.

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

  • O comprimento do paths parâmetro não pode ser superior a 256 caracteres para uma base de dados SQL.

  • O comprimento do usernames parâmetro não pode ser superior a 256 caracteres para uma base de dados SQL.

Aplica-se a