Freigeben über

PersonalizationProvider.ResetState Methode

  • Referenz

Definition

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

Wenn in einer abgeleiteten Klasse überschrieben, wird der Personalisierungszustand aus dem zugrunde liegenden Datenspeicher basierend auf den festgelegten Parametern 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

Ein 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 ihre Vorgänge als einzelne atomische Transaktion ausführen.

Nur die folgenden Kombinationen von Parametern sind zulässig:

  • Der scope Parameter ist festgelegt, und alle anderen Parameter sind auf nullfestgelegt. Diese Kombination löscht alle Webparts-Personalisierungsdaten, die dem durch angegebenen Personalisierungsbereich zugeordnet sind scope.

  • Der scope Parameter ist festgelegt, und der paths Parameter enthält mindestens einen Wert. Diese Kombination löscht alle Webparts-Personalisierungsdaten für den angegebenen Pfad bzw. die angegebenen Pfade im durch scopeangegebenen Personalisierungsbereich.

  • Der scope Parameter ist auf Userfestgelegt, der paths Parameter ist festgelegt und enthält nur einen Wert, und der usernames Parameter enthält mindestens einen Wert. Diese Kombination löscht alle Benutzerpersonalisierungs-Webparts-Daten für den angegebenen Pfad, der dem Benutzer oder den Benutzern zugeordnet ist, die in usernamesenthalten sind.

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

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

  • Der usernames Parameter kann nicht bereitgestellt werden, wenn scope auf Sharedfestgelegt ist.

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

Alle paths Parameterwerte und usernames , die in den jeweiligen Arrays enthalten sind, müssen die folgenden Validierungsregeln erfüllen. Wenn Validierungsregeln für ein Element der Parameterarrays fehlschlagen, wird eine ArgumentException Ausnahme ausgelöst. Die Validierungsregeln sind:

  • null -Werte sind nicht zulässig.

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

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

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

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

Gilt für: