This documentation is archived and is not being maintained.

SqlMembershipProvider.EnablePasswordRetrieval Property

Gets a value indicating whether the SQL Server membership provider is configured to allow users to retrieve their passwords.

Namespace:  System.Web.Security
Assembly:  System.Web (in System.Web.dll)

public override bool EnablePasswordRetrieval { get; }

Property Value

Type: System.Boolean
true if the membership provider supports password retrieval; otherwise, false. The default is false.

If the PasswordFormat property is set to Hashed, a user will not be able to retrieve his or her existing password from the database. The Hashed password format provides one-way encoding of password values. Passwords are hashed with a randomly generated salt value and compared to values stored in the database for authentication. Hashed values cannot be unencoded to retrieve the original password value.

If the PasswordFormat property is set to Hashed, and EnablePasswordRetrieval is set to true, a ProviderException is thrown when the provider is initialized.

The following code example shows the membership element in the system.web section of the Web.config file for an ASP.NET application. It specifies the application's SqlMembershipProvider instance and enables password retrieval.

<membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="20">
    <add name="SqlProvider"
      applicationName="MyApplication" />

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.