SqlPersonalizationProvider.ResetState Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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[] -> intPublic Overrides Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As IntegerParameter
- scope
- PersonalizationScope
Ein PersonalizationScope, der die abzufragenden Personalisierungsinformationen angibt. Dieser Wert darf nicht null sein.
- usernames
- String[]
Die Benutzernamen für die zu löschenden Personalisierungsinformationen im User-Bereich.
Gibt zurück
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
scopeParameter wird festgelegt, und alle anderen Parameter werden aufnullfestgelegt. Diese Kombination löscht alle Webparts-Personalisierungsdaten, die dem von ihnen angegebenen Personalisierungsbereich zugeordnet sindscope.Der
scopeParameter wird festgelegt, und derpathsParameter enthält mindestens einen Wert. Diese Kombination löscht alle Webparts-Personalisierungsdatenscopefür den angegebenen Pfad oder Pfad, der im von .Der Parameter wird auf Userfestgelegt, der
scopeParameter wird festgelegt und enthält nur einen Pfad, und derusernamespathsParameter 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 enthaltenusernamesist.Der
scopeParameter wird auf Userfestgelegt, der Parameter istnull, und derusernamespathsParameter 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 sieusernamesenthalten 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
usernamesParameter kann nicht bereitgestellt werden, wenn derscopeParameter auf Shared".Der
pathsParameter kann nicht mehr als einen Eintrag enthalten, wenn derusernamesParameter nichtnullangegeben 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:
nullWerte sind nicht zulässig.Eine leere Zeichenfolge ("") nach dem Kürzen der Zeichenfolge ist nicht zulässig.
Es kann keine Benutzernamen enthalten sein, die
usernamesim Parameter enthalten sind.Die Länge eines Pfads im
pathsParameter kann nicht größer als 256 Zeichen sein.Die Länge eines Benutzernamens im
usernamesParameter kann nicht größer als 256 Zeichen sein.