Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo PersonalizationProvider.ResetState

Quando viene sottoposto a override in una classe derivata, elimina lo stato di personalizzazione dell'archivio dati sottostante sulla base dei 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
Tipo: System.Web.UI.WebControls.WebParts.PersonalizationScope
Oggetto PersonalizationScope che indica le informazioni sulla personalizzazione da reimpostare. Questo valore non può essere null.
paths
Tipo: System.String[]
Percorsi per le informazioni sulla personalizzazione da eliminare.
usernames
Tipo: System.String[]
Nomi utente per le informazioni sulla personalizzazione da eliminare.

Valore restituito

Tipo: System.Int32
Il numero di righe eliminate.

Questo metodo è la definizione astratta di un metodo amministrativo per eliminare i dati sulla personalizzazione. Le implementazioni derivate devono seguire la logica descritta di seguito.

Questo metodo non supporta le ricerche con caratteri jolly. Se il provider di personalizzazioni espone i dati di un archivio dati con supporto delle transazioni, questo metodo deve eseguire le relative operazioni in una singola transazione atomica.

Sono consentite solo le seguenti combinazioni di parametri:

  • Il parametro scope è impostato, mentre il valore di tutti gli altri parametri è null. Questa combinazione elimina tutti i dati sulla personalizzazione di Web part associati all'ambito di personalizzazione indicato dal parametro scope.

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

  • Il parametro scope è impostato su User, il parametro paths è impostato e contiene solo un valore e il parametro usernames contiene almeno un valore. Questa combinazione elimina tutti i dati di Web part sulla personalizzazione utente relativi a un percorso specificato associati all'utente o agli utenti contenuti nel parametro usernames.

  • Il parametro scope è impostato su User, il parametro paths è impostato su null e il parametro usernames contiene almeno un valore. Questa combinazione elimina tutti i dati Web part sulla personalizzazione per singolo utente, attraverso tutti i percorsi, associati all'utente o agli utenti contenuti nel parametro usernames.

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

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

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

Tutti i valori dei parametri paths e usernames contenuti nelle rispettive matrici devono soddisfare le seguenti regole di convalida. Se una regola di convalida non viene applicata per un membro delle matrici di parametri, verrà generata un'eccezione ArgumentException. Le regole di convalida comprendono:

  • I valori null non sono consentiti.

  • Una stringa vuota ("") non è consentita. È necessario tagliare i parametri prima di eseguire una verifica delle stringhe vuote.

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

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

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

.NET Framework

Supportato in: 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 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft