PersonalizationProvider.ResetState Metod

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

När det åsidosätts i en härledd klass tar bort anpassningstillståndet från det underliggande datalagret baserat på de angivna parametrarna.

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

Parametrar

scope
PersonalizationScope

En PersonalizationScope av de anpassningsinformation som ska återställas. Det här värdet får inte vara null.

paths
String[]

Sökvägarna för anpassningsinformation som ska tas bort.

usernames
String[]

Användarnamnen för anpassningsinformation som ska tas bort.

Returer

Int32

Antalet rader som har tagits bort.

Kommentarer

Den här metoden är den abstrakta definitionen av en administrativ metod för att ta bort anpassningsdata. Härledda implementeringar bör följa den logik som beskrivs nedan.

Inga jokerteckensökningar stöds av den här metoden. Om personanpassningsprovidern exponerar data från ett transaktionsmedveten datalager bör den här metoden utföra sina åtgärder som en enda atomisk transaktion.

Endast följande kombinationer av parametrar tillåts:

  • Parametern scope har angetts och alla andra parametrar är inställda på null. Den här kombinationen tar bort alla anpassningsdata för webbdelar som är associerade med anpassningsomfånget som anges av scope.

  • Parametern scope anges och parametern paths innehåller minst ett värde. Den här kombinationen tar bort alla webbdelars anpassningsdata för den angivna sökvägen eller sökvägarna i anpassningsomfånget som anges av scope.

  • Parametern scope är inställd på User, parametern paths anges och innehåller bara ett värde och parametern usernames innehåller minst ett värde. Den här kombinationen tar bort alla webbdelsdata för användaranpassning för den angivna sökvägen som är associerad med användaren eller användarna i usernames.

  • Parametern scope är inställd på User, parametern paths är inställd på null, och parametern usernames innehåller minst ett värde. Den här kombinationen tar bort alla webbdelsdata per användare, över alla sökvägar som är associerade med användaren eller användarna i usernames.

Alla andra kombinationer av parametervärden är ogiltiga och utlöser ett ArgumentException undantag. Mer specifikt tillåts inte följande två kombinationer:

  • Parametern usernames kan inte anges när scope är inställd på Shared.

  • Parametern paths får inte innehålla mer än en post när parametern usernames inte nullär .

Alla paths värden och usernames parametervärden som finns i respektive matriser måste uppfylla följande verifieringsregler. Om några verifieringsregler misslyckas för någon medlem i parametermatriserna utlöses ett ArgumentException undantag. Verifieringsreglerna är:

  • null värden tillåts inte.

  • En tom sträng ("") tillåts inte. Parametrar bör trimmas innan du utför en tom strängkontroll.

  • Parametern usernames får inte innehålla kommatecken (,).

  • Parameterns paths längd får inte vara större än 256 tecken för en SQL-databas.

  • Parameterns usernames längd får inte vara större än 256 tecken för en SQL-databas.

Gäller för