PersonalizationProvider.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.
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[] -> intPublic MustOverride Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As IntegerParameter
- 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
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
scopeParameter ist festgelegt, und alle anderen Parameter sind aufnullfestgelegt. Diese Kombination löscht alle Webparts-Personalisierungsdaten, die dem durch angegebenen Personalisierungsbereich zugeordnet sindscope.Der
scopeParameter ist festgelegt, und derpathsParameter enthält mindestens einen Wert. Diese Kombination löscht alle Webparts-Personalisierungsdaten für den angegebenen Pfad bzw. die angegebenen Pfade im durchscopeangegebenen Personalisierungsbereich.Der
scopeParameter ist auf Userfestgelegt, derpathsParameter ist festgelegt und enthält nur einen Wert, und derusernamesParameter 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 inusernamesenthalten sind.Der
scopeParameter ist auf Userfestgelegt, derpathsParameter ist aufnullfestgelegt, und derusernamesParameter 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 inusernamesenthalten 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
usernamesParameter kann nicht bereitgestellt werden, wennscopeauf Sharedfestgelegt ist.Der
pathsParameter darf nicht mehr als einen Eintrag enthalten, wenn derusernamesParameter nichtnullist.
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
usernamesParameter darf keine Kommas (,) enthalten.Die Länge des
pathsParameters darf für eine SQL-Datenbank nicht größer als 256 Zeichen sein.Die Länge des
usernamesParameters darf für eine SQL-Datenbank nicht größer als 256 Zeichen sein.
