SqlPersonalizationProvider.ResetState Metodo

Definizione

Elimina le informazioni di stato sulla 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 sulla personalizzazione su cui eseguire la query. Questo valore non può essere null.

paths
String[]

Percorsi per le informazioni sulla personalizzazione nell'ambito del campo Shared da eliminare.

usernames
String[]

Nomi utente per le informazioni sulla personalizzazione nell'ambito del campo User da eliminare.

Restituisce

Int32

Il numero di righe eliminate.

Eccezioni

Il parametro paths o il parametro usernames è una matrice vuota.

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

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

Commenti

Questo metodo non supporta caratteri jolly.

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:

  • Impossibile 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