PersonalizationAdministration.ResetState Method
Assembly: System.Web (in system.web.dll)
public static int ResetState ( PersonalizationStateInfoCollection data )
public static function ResetState ( data : PersonalizationStateInfoCollection ) : int
Parameters
- data
A collection of PersonalizationStateInfo objects indicating what data should be reset.
Return Value
The number of rows that were reset.| Exception type | Condition |
|---|---|
| data is a null reference (Nothing in Visual Basic). | |
| data is an empty collection. - or - An element of the collection is a null reference (Nothing in Visual Basic). - or - The path value of a UserPersonalizationStateInfo instance in the collection is a null reference (Nothing in Visual Basic) or an empty string (""). - or - The user value of a UserPersonalizationStateInfo instance in the collection is a null reference (Nothing in Visual Basic), an empty string, or contains commas. - or - The provider for a personalization provider defined in configuration is not of the correct type. - or - The length of the string of any parameter is greater than 256 characters. | |
| A configuration exception occurred while attempting to create and initialize an instance of one of the configured personalization providers. - or - The default personalization provider defined in configuration could not be found. | |
| The default provider indicated that the number of deleted rows was a negative number. |
This method resets personalization data in the underlying data store, based on the PersonalizationStateInfo objects contained in the collection. You can use this method to selectively delete a mixture of shared and per-user data based on the collection's contents. SharedPersonalizationStateInfo objects indicate that shared data for a page will be reset; UserPersonalizationStateInfo objects indicate that per-user data for a specific page will be reset.
Note |
|---|
| This method does not guarantee that all resets occur within a single transaction because the collection points to random sets of personalization data. |
It is not an error for the collection to contain objects that reference nonexistent data.
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
Reference
PersonalizationAdministration ClassPersonalizationAdministration Members
System.Web.UI.WebControls.WebParts Namespace
WebPartPersonalization
Other Resources
ASP.NET Web Parts PagesWeb Parts Personalization Overview
Walkthrough: Implementing Web Parts Personalization with a User Control
Web Parts Personalization
Note