ActiveDirectoryMembershipProvider.RequiresUniqueEmail 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 a value indicating whether an email address stored on the Active Directory server must be unique.

public:
 virtual property bool RequiresUniqueEmail { bool get(); };

public override bool RequiresUniqueEmail { get; }

member this.RequiresUniqueEmail : bool

Public Overrides ReadOnly Property RequiresUniqueEmail As Boolean

Property Value

Boolean

true if email addresses must be unique; otherwise, false. The default is false.

Exceptions

InvalidOperationException

An attempt to access the RequiresUniqueEmail property was made before the ActiveDirectoryMembershipProvider instance was initialized.

Examples

The following code example shows a Web.config entry that configures an ActiveDirectoryMembershipProvider instance to require unique email addresses for users stored on the Active Directory server.

<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"  
          requiresUniqueEmail="true" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>

Remarks

When the RequiresUniqueEmail property is true, the ActiveDirectoryMembershipProvider instance ensures that the email address is not used by any other user within the current scope when either the CreateUser or UpdateUser method is called.

The RequiresUniqueEmail property is set in your application's configuration file using the requiresUniqueEmail attribute of the membership Element (ASP.NET Settings Schema) element. If the property is not set in the application's configuration file, the RequiresUniqueEmail property is set to the default value of false.

Applies to