ActiveDirectoryMembershipProvider.PasswordStrengthRegularExpression Property

Reference

Definition

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the regular expression used to evaluate a password.

public:
 virtual property System::String ^ PasswordStrengthRegularExpression { System::String ^ get(); };

public override string PasswordStrengthRegularExpression { get; }

member this.PasswordStrengthRegularExpression : string

Public Overrides ReadOnly Property PasswordStrengthRegularExpression As String

Property Value

String

A regular expression used to evaluate a password.

Exceptions

InvalidOperationException

The PasswordStrengthRegularExpression property is accessed before the ActiveDirectoryMembershipProvider instance is initialized.

Examples

The following example shows the membership Element (ASP.NET Settings Schema) configuration element in the system.web section of the application's Web.config file. It specifies that the application use an instance of the ActiveDirectoryMembershipProvider class to provide membership services and sets the passwordStrengthRegularExpression attribute to a regular expression that validates that the password meets the following criteria:

Is greater than seven characters.
Contains at least one digit.
Contains at least one special (non-alphanumeric) character.

If the password does not meet these criteria, the password is not accepted by the membership provider.

<configuration>  
  <connectionStrings>  
    <add name="ADService" connectionString="LDAP://ldapServer/" />  
  </connectionStrings>  
  <system.web>  
    <membership defaultProvider="AspNetActiveDirectoryMembershipProvider">  
      <providers>  
        <add name="AspNetActiveDirectoryMembershipProvider"   
          type="System.Web.Security.ActiveDirectoryMembershipProvider,   
          System.Web, Version=2.0.3600, Culture=neutral,   
          PublicKeyToken=b03f5f7f11d50a3a"  
          passwordStrengthRegularExpression=  
            "@\"(?=.{6,})(?=(.*\d){1,})(?=(.*\W){1,})" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>

Remarks

The PasswordStrengthRegularExpression property gets the regular expression used to evaluate password complexity.

The PasswordStrengthRegularExpression property is not used to validate auto-generated passwords in the ResetPassword method.

The PasswordStrengthRegularExpression property is set in the application configuration using the passwordStrengthRegularExpression attribute of the membership Element (ASP.NET Settings Schema) configuration element.

Applies to