SqlPersonalizationProvider.ResetState Methode

Definition

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

Löscht Personalisierungsstatusinformationen aus dem zugrunde liegenden Datenspeicher basierend auf den angegebenen Parametern.

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

Parameter

scope
PersonalizationScope

Ein PersonalizationScope Hinweis, der die zu abfragenden Personalisierungsinformationen angibt. Dieser Wert darf nicht null sein.

paths
String[]

Die Pfade für Personalisierungsinformationen im Shared Zu löschenden Bereich.

usernames
String[]

Die Benutzernamen für Personalisierungsinformationen im User zu löschenden Bereich.

Gibt zurück

Int32

Die Anzahl der gelöschten Zeilen.

Ausnahmen

ArgumentException

Entweder der paths Parameter oder der usernames Parameter ist ein leeres Array.

-oder-

paths Die usernames in den jeweiligen Arrays enthaltenen Parameter entsprechen nicht den Gültigkeitsprüfungsregeln.

ArgumentOutOfRangeException

Das scope angegebene Element ist kein Element der PersonalizationScope Enumeration.

Hinweise

Von dieser Methode werden keine Wildcardzeichen unterstützt.

Es sind nur die folgenden Kombinationen von Parametern zulässig:

  • Der scope Parameter wird festgelegt, und alle anderen Parameter werden auf null. Diese Kombination löscht alle Webparts-Personalisierungsdaten, die mit dem durch scopeden Personalisierungsbereich angegebenen Bereich verknüpft sind.

  • Der scope Parameter wird festgelegt, und der paths Parameter enthält mindestens einen Wert. Diese Kombination löscht alle Webparts-Personalisierungsdaten für den angegebenen Pfad oder Pfad, die sich im durch scopeden Personalisierungsbereich angegebenen Bereich befinden.

  • Der scope Parameter wird auf festgelegt, der User Parameter wird festgelegt pathsund enthält nur einen Pfad, und der usernames Parameter enthält mindestens einen Wert. Diese Kombination löscht alle Benutzerpersonalisierungswebparts-Daten für den angegebenen Pfad, der dem Benutzer oder benutzern zugeordnet ist, in usernamesdem enthalten ist.

  • Der scope Parameter ist auf User, der paths Parameter ist nullfestgelegt, und der usernames Parameter enthält mindestens einen Wert. Diese Kombination löscht alle Personalisierungswebparts-Daten pro Benutzer über alle Pfade hinweg, die dem Benutzer oder den Benutzern zugeordnet sind, die in usernames.

Eine andere Kombination von Parameterwerten ist ungültig und löst eine ArgumentException Ausnahme aus. Die folgenden beiden Kombinationen sind beispielsweise nicht zulässig:

  • Der usernames Parameter kann nicht angegeben werden, wenn der scope Parameter auf Shared.

  • Der paths Parameter darf nicht mehr als einen Eintrag enthalten, wenn der usernames Parameter nicht nullangegeben ist.

paths Die usernames in den jeweiligen Arrays enthaltenen Parameter müssen die folgenden Gültigkeitsprüfungsregeln erfüllen. Wenn gültigkeitsprüfungsregeln für ein Element der Parameterarrays fehlschlagen, wird eine ArgumentException Ausnahme ausgelöst. Zu den Gültigkeitsprüfungsregeln gehören:

  • null Werte sind nicht zulässig.

  • Eine leere Zeichenfolge ("") nach dem Kürzen der Zeichenfolge ist nicht zulässig.

  • Im Parameter enthaltene Benutzernamen usernames können keine Kommas enthalten.

  • Die Länge eines Pfads paths im Parameter darf nicht größer als 256 Zeichen sein.

  • Die Länge eines Benutzernamens usernames im Parameter darf nicht größer als 256 Zeichen sein.

Gilt für: