PersonalizationProvider.ResetState Methode

Definitie

Naamruimte:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Wanneer deze wordt overschreven in een afgeleide klasse, verwijdert u de persoonlijke status uit het onderliggende gegevensarchief op basis van de opgegeven parameters.

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

Parameters

scope
PersonalizationScope

Een PersonalizationScope van de persoonlijke gegevens die opnieuw moeten worden ingesteld. Deze waarde kan niet zijn null.

paths
String[]

De paden voor het verwijderen van persoonlijke gegevens.

usernames
String[]

De gebruikersnamen voor persoonlijke gegevens die moeten worden verwijderd.

Retouren

Int32

Het aantal rijen dat is verwijderd.

Opmerkingen

Deze methode is de abstracte definitie van een beheermethode voor het verwijderen van persoonlijke gegevens. Afgeleide implementaties moeten de hieronder beschreven logica volgen.

Er worden geen zoekopdrachten met jokertekens ondersteund door deze methode. Als de personalisatieprovider gegevens uit een transactiebewust gegevensarchief beschikbaar maakt, moet deze methode de bewerkingen uitvoeren als één atomische transactie.

Alleen de volgende combinaties van parameters zijn toegestaan:

  • De scope parameter is ingesteld en alle andere parameters zijn ingesteld op null. Met deze combinatie worden alle persoonlijke gegevens van webonderdelen verwijderd die zijn gekoppeld aan het persoonlijke bereik dat wordt aangegeven door scope.

  • De scope parameter is ingesteld en de paths parameter bevat ten minste één waarde. Met deze combinatie worden alle persoonlijke gegevens van webonderdelen verwijderd voor het opgegeven pad of de opgegeven paden in het persoonlijke bereik dat wordt aangegeven door scope.

  • De scope parameter is ingesteld op User, de paths parameter is ingesteld en bevat slechts één waarde en de usernames parameter bevat ten minste één waarde. Met deze combinatie worden alle gegevens van webonderdelen voor gebruikers persoonlijke instellingen verwijderd voor het opgegeven pad dat is gekoppeld aan de gebruiker of gebruikers in usernames.

  • De scope parameter is ingesteld op User, de paths parameter is ingesteld op nullen de usernames parameter bevat ten minste één waarde. Met deze combinatie worden alle gegevens van webonderdelen voor persoonlijke instellingen per gebruiker verwijderd, op alle paden, gekoppeld aan de gebruiker of gebruikers in usernames.

Elke andere combinatie van parameterwaarden is ongeldig en genereert een ArgumentException uitzondering. De volgende twee combinaties zijn niet toegestaan:

  • De usernames parameter kan niet worden opgegeven wanneer scope deze is ingesteld op Shared.

  • De paths parameter mag niet meer dan één vermelding bevatten wanneer de usernames parameter niet nullis.

Alle paths waarden en usernames parameterwaarden in de respectieve matrices moeten voldoen aan de volgende validatieregels. Als validatieregels mislukken voor een lid van de parametermatrices, wordt er een ArgumentException uitzondering gegenereerd. De validatieregels zijn:

  • null waarden zijn niet toegestaan.

  • Een lege tekenreeks ("") is niet toegestaan. Parameters moeten worden ingekort voordat u een lege tekenreekscontrole uitvoert.

  • De usernames parameter mag geen komma's (,) bevatten.

  • De lengte van de paths parameter mag niet langer zijn dan 256 tekens voor een SQL-database.

  • De lengte van de usernames parameter mag niet langer zijn dan 256 tekens voor een SQL-database.

Van toepassing op