PersonalizationAdministration.ResetState Methode

  • Referenz

Definition

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

Setzt Personalisierungsdaten im zugrunde liegenden Datenspeicher zurück, basierend auf den in der Sammlung enthaltenen Elementen.

public:
 static int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ data);
public static int ResetState (System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection data);
static member ResetState : System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection -> int
Public Shared Function ResetState (data As PersonalizationStateInfoCollection) As Integer

Parameter

data
PersonalizationStateInfoCollection

Eine Sammlung von PersonalizationStateInfo-Objekten, die angeben, welche Daten zurückgesetzt werden sollen.

Gibt zurück

Int32

Die Anzahl von Zeilen, die zurückgesetzt wurden.

Ausnahmen

ArgumentNullException

data ist null.

ArgumentException

data ist eine leere Sammlung.

- oder -

Ein Element der Sammlung ist null.

- oder -

Der Pfadwert einer UserPersonalizationStateInfo-Instanz in der Sammlung ist null oder eine leere Zeichenfolge ("").

- oder -

Der user-Wert einer UserPersonalizationStateInfo-Instanz in der Sammlung ist null, ist eine leere Zeichenfolge oder enthält Kommas.

- oder -

Der Anbieter für einen in der Konfiguration definierten Personalisierungsanbieter weist nicht den richtigen Typ auf.

- oder -

Die Länge der Zeichenfolge eines beliebigen Parameters beträgt mehr als 256 Zeichen.

ConfigurationErrorsException

Beim Versuch, eine Instanz eines konfigurierten Personalisierungsanbieters zu erstellen und zu initialisieren, ist eine Konfigurationsausnahme aufgetreten.

- oder -

Der in der Konfiguration definierte standardmäßige Personalisierungsanbieter wurde nicht gefunden.

HttpException

Der Standardanbieter hat angegeben, dass die Anzahl von gelöschten Zeilen eine negative Zahl war.

Hinweise

Diese Methode setzt Personalisierungsdaten im zugrunde liegenden Datenspeicher basierend auf den in der PersonalizationStateInfo Auflistung enthaltenen Objekten zurück. Sie können diese Methode verwenden, um eine Mischung aus freigegebenen und benutzerspezifischen Daten basierend auf dem Inhalt der Sammlung selektiv zu löschen. SharedPersonalizationStateInfo -Objekte zeigen an, dass freigegebene Daten für eine Seite zurückgesetzt werden. UserPersonalizationStateInfo -Objekte geben an, dass benutzerspezifische Daten für eine bestimmte Seite zurückgesetzt werden.

Hinweis

Diese Methode garantiert nicht, dass alle Zurücksetzungen innerhalb einer einzelnen Transaktion erfolgen, da die Sammlung auf zufällige Sätze von Personalisierungsdaten verweist.

Es ist kein Fehler, dass die Auflistung Objekte enthält, die auf nicht vorhandene Daten verweisen.

Gilt für:

Weitere Informationen