SqlProfileProvider.DeleteProfiles Method (String[])
Assembly: System.Web (in system.web.dll)
| Exception type | Condition |
|---|---|
| The length of usernames is zero. - or - One of the items in usernames is an empty string (""), exceeds a length of 256 characters, or contains a comma. - or - Two or more items in usernames have the same value. | |
| usernames is a null reference (Nothing in Visual Basic). - or - One of the items in usernames is a null reference (Nothing in Visual Basic). |
The DeleteProfiles method deletes all profile information and properties for the specified profiles from the data source for the application specified by the applicationName attribute in the configuration file. The list of profiles to delete is specified as a string array of user names. If profile properties and information exist in the data source for a user name in the usernames parameter, they are deleted.
The return value may differ from the length of the specified array of usernames. This indicates that some of the profiles in the specified array of usernames were already deleted from the data store.
The database updates that are performed during the call to the DeleteProfiles method are made within a transaction. If an error is encountered, the transaction is rolled back and no updates are performed.
The following code example shows an ASP.NET page that manages inactive profiles. A GridView control displays the inactive profiles returned. Each row of the GridView control includes a button that deletes the profile for that row from the data source with a call to the DeleteProfiles method.
Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.