PersonalizationProvider.ResetState Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Quando viene sottoposto a override in una classe derivata, elimina lo stato di personalizzazione dell'archivio dati sottostante sulla base dei parametri specificati.

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

Parametri

scope

PersonalizationScope

Oggetto PersonalizationScope che indica le informazioni sulla personalizzazione da reimpostare. Questo valore non può essere null.

paths

String[]

Percorsi per le informazioni sulla personalizzazione da eliminare.

usernames

String[]

Nomi utente per le informazioni sulla personalizzazione da eliminare.

Restituisce

Int32

Il numero di righe eliminate.

Commenti

Questo metodo è la definizione astratta di un metodo amministrativo per l'eliminazione dei dati di personalizzazione. Le implementazioni derivate devono seguire la logica descritta di seguito.

Nessuna ricerca di caratteri jolly è supportata da questo metodo. Se il provider di personalizzazione espone i dati da un archivio dati compatibile con le transazioni, questo metodo deve eseguire le operazioni come singola transazione atomica.

Sono consentite solo le combinazioni di parametri seguenti:

• Il scope parametro è impostato e tutti gli altri parametri sono impostati su null. Questa combinazione elimina tutti i dati di personalizzazione delle web part associati all'ambito di personalizzazione indicato da scope.

• Il scope parametro è impostato e il paths parametro contiene almeno un valore. Questa combinazione elimina tutti i dati di personalizzazione delle web part per il percorso o i percorsi specificati nell'ambito di personalizzazione indicato da scope.

• Il scope parametro è impostato su User, il paths parametro è impostato e contiene un solo valore e il usernames parametro contiene almeno un valore. Questa combinazione elimina tutti i dati delle web part di personalizzazione utente per il percorso specificato associato all'utente o agli utenti contenuti in usernames.

• Il scope parametro è impostato su User, il paths parametro è impostato su nulle il usernames parametro contiene almeno un valore. Questa combinazione elimina tutti i dati delle web part di personalizzazione per utente, in tutti i percorsi, associati all'utente o agli utenti contenuti in usernames.

Qualsiasi altra combinazione di valori di parametro non è valida e genererà un'eccezione ArgumentException . In particolare, le due combinazioni seguenti non sono consentite:

• Non è possibile specificare il usernames parametro quando scope è impostato su Shared.

• Il paths parametro non può contenere più di una voce quando il usernames parametro non nullè .

I valori dei paths parametri e usernames contenuti nelle rispettive matrici devono soddisfare le regole di convalida seguenti. Se le regole di convalida hanno esito negativo per qualsiasi membro delle matrici di parametri, viene generata un'eccezione ArgumentException . Le regole di convalida sono:

• null i valori non sono consentiti.

• Non è consentita una stringa vuota (""). I parametri devono essere tagliati prima di eseguire un controllo stringa vuoto.

• Il usernames parametro non può contenere virgole (,).

• La lunghezza del paths parametro non può essere maggiore di 256 caratteri per un database SQL.

• La lunghezza del usernames parametro non può essere maggiore di 256 caratteri per un database SQL.