Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo PersonalizationProvider.ResetState (PersonalizationScope, String[], String[])

 

Data di pubblicazione: ottobre 2016

Quando sottoposto a override in una classe derivata, Elimina lo stato di personalizzazione dall'archivio dati sottostante in base ai parametri specificati.

Spazio dei nomi:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

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

Parametri

scope
Type: System.Web.UI.WebControls.WebParts.PersonalizationScope

Oggetto PersonalizationScope delle informazioni di personalizzazione da reimpostare. Questo valore non può essere null.

paths
Type: System.String[]

I percorsi per le informazioni sulla personalizzazione da eliminare.

usernames
Type: System.String[]

I nomi utente per le informazioni sulla personalizzazione da eliminare.

Valore restituito

Type: System.Int32

Il numero di righe eliminate.

Questo metodo è la definizione astratta di un metodo amministrativo per l'eliminazione di 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 personalizzazioni espone i dati da un archivio dati di supporto delle transazioni, questo metodo deve eseguire le operazioni come una singola transazione atomica.

Sono consentite solo le seguenti combinazioni di parametri:

  • Il scope parametro è impostato, e tutti gli altri parametri vengono impostati su null. Questa combinazione elimina tutti i dati di personalizzazione di Web part associati all'ambito di personalizzazione indicato dal scope.

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

  • Il scope parametro è impostato su User, paths parametro è impostato e contiene un solo valore e usernames parametro contiene almeno un valore. Questa combinazione elimina tutti la personalizzazione dei dati di Web part per il percorso specificato è associato a uno o più utenti contenuti in usernames.

  • Il scope parametro è impostato su User, paths parametro è impostato su null, e usernames parametro contiene almeno un valore. Questa combinazione elimina dati di Web part, sulla personalizzazione per singolo utente tutti attraverso tutti i percorsi, associati a uno o più utenti contenuti in usernames.

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

  • Il usernames parametro non può essere fornito quando scope è impostato su Shared.

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

Qualsiasi paths e usernames i valori dei parametri contenuti nelle rispettive matrici devono soddisfare le seguenti regole di convalida. Se le regole di convalida non riesce per qualsiasi membro delle matrici di parametro, un ArgumentException viene generata un'eccezione. Le regole di convalida sono:

  • null i valori non sono consentiti.

  • Una stringa vuota ("") non è consentito. I parametri devono essere tagliati prima di eseguire un controllo di una stringa vuota.

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

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

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

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: