SqlPersonalizationProvider.ResetState Metodo

Definizione

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

Elimina le informazioni sullo stato di personalizzazione dall'archivio dati sottostante, in base ai parametri specificati.

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

Parametri

scope
PersonalizationScope

Oggetto PersonalizationScope che indica le informazioni di personalizzazione su cui eseguire query. Questo valore non può essere null.

paths
String[]

Percorsi per le informazioni di personalizzazione nell'ambito Shared da eliminare.

usernames
String[]

Nomi utente per le informazioni di personalizzazione nell'ambito User da eliminare.

Valori restituiti

Int32

Numero di righe eliminate.

Eccezioni

ArgumentException

O il pathsusernames parametro è una matrice vuota.

oppure

I paths parametri e usernames contenuti nelle rispettive matrici non soddisfano le regole di convalida.

ArgumentOutOfRangeException

L'oggetto scope specificato non è un membro dell'enumerazione PersonalizationScope .

Commenti

Nessun carattere jolly è supportato da questo metodo.

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 percorso 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 è 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 . Ad esempio, le due combinazioni seguenti non sono consentite:

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

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

I 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 includono:

  • null i valori non sono consentiti.

  • Stringa vuota ("") dopo che la stringa è stata tagliata non è consentita.

  • Nessun nome utente contenuto nel usernames parametro può contenere virgole.

  • La lunghezza di qualsiasi percorso nel paths parametro non può essere maggiore di 256 caratteri.

  • La lunghezza di qualsiasi nome utente nel usernames parametro non può essere maggiore di 256 caratteri.

Si applica a