PersonalizationProvider.ResetState Methode

Definition

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

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Personalisierungsstatus basierend auf den angegebenen Parametern aus dem zugrunde liegenden Datenspeicher gelöscht.

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

Parameter

scope
PersonalizationScope

Eine PersonalizationScope der Personalisierungsinformationen, die zurückgesetzt werden sollen. Dieser Wert darf nicht null sein.

paths
String[]

Die Pfade für Personalisierungsinformationen, die gelöscht werden sollen.

usernames
String[]

Die Benutzernamen für Personalisierungsinformationen, die gelöscht werden sollen.

Gibt zurück

Int32

Die Anzahl der gelöschten Zeilen.

Hinweise

Diese Methode ist die abstrakte Definition einer administrativen Methode zum Löschen von Personalisierungsdaten. Abgeleitete Implementierungen sollten der unten beschriebenen Logik folgen.

Von dieser Methode werden keine Wildcardzeichensuchen unterstützt. Wenn der Personalisierungsanbieter Daten aus einem transaktionsfähigen Datenspeicher verfügbar macht, sollte diese Methode seine Vorgänge als einzelne atombasierte Transaktion ausführen.

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 im durch scopeangegebenen Personalisierungsbereich angegeben.

  • Der scope Parameter ist auf Userfestgelegt, der paths Parameter wird festgelegt und enthält nur einen Wert, 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 auf festgelegt null, 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. Insbesondere sind die folgenden beiden Kombinationen nicht zulässig:

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

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

paths Alle usernames parameterwerte, die in den jeweiligen Arrays enthalten sind, 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. Die Gültigkeitsprüfungsregeln sind:

  • null Werte sind nicht zulässig.

  • Eine leere Zeichenfolge ("") ist nicht zulässig. Parameter sollten vor dem Ausführen einer leeren Zeichenfolgenüberprüfung gekürzt werden.

  • Der usernames Parameter darf keine Kommas (,) enthalten.

  • Die Länge des paths Parameters darf nicht größer als 256 Zeichen für eine SQL-Datenbank sein.

  • Die Länge des usernames Parameters darf nicht größer als 256 Zeichen für eine SQL-Datenbank sein.

Gilt für: