Freigeben über


SqlPersonalizationProvider.ResetState Methode

Definition

Löscht auf der Grundlage der angegebenen Parameter Personalisierungszustandsinformationen aus dem zugrunde liegenden Datenspeicher.

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, der die abzufragenden Personalisierungsinformationen angibt. Dieser Wert darf nicht null sein.

paths
String[]

Die Pfade für die zu löschenden Personalisierungsinformationen im Shared-Bereich.

usernames
String[]

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

Gibt zurück

Int32

Die Anzahl der gelöschten Zeilen.

Ausnahmen

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

- oder - Der paths-Parameter sowie der usernames-Parameter in den entsprechenden Arrays entspricht nicht den Validierungsregeln.

Das angegebene scope ist kein Member der PersonalizationScope-Enumeration.

Hinweise

Es werden keine Wildcardzeichen von dieser Methode unterstützt.

Nur die folgenden Kombinationen von Parametern sind zulässig:

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

  • Der scope Parameter wird festgelegt, und der paths Parameter enthält mindestens einen Wert. Diese Kombination löscht alle Webparts-Personalisierungsdaten scopefür den angegebenen Pfad oder Pfad, der im von .

  • Der Parameter wird auf Userfestgelegt, der scope Parameter wird festgelegt und enthält nur einen Pfad, und der usernames paths 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 der enthalten usernamesist.

  • Der scope Parameter wird auf Userfestgelegt, der Parameter ist null, und der usernames paths Parameter enthält mindestens einen Wert. Diese Kombination löscht alle Daten für die Benutzerpersonalisierung von Webparts über alle Pfade hinweg, die dem Benutzer oder benutzern zugeordnet sind, in dem sie usernamesenthalten sind.

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

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

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

usernames Die paths in den jeweiligen Arrays enthaltenen Parameter müssen die folgenden Überprüfungsregeln erfüllen. Wenn eine Überprüfungsregeln für ein Element der Parameterarrays fehlschlägt, wird eine ArgumentException Ausnahme ausgelöst. Die Überprüfungsregeln umfassen:

  • null Werte sind nicht zulässig.

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

  • Es kann keine Benutzernamen enthalten sein, die usernames im Parameter enthalten sind.

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

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

Gilt für