ActiveDirectoryMembershipProvider.RequiresUniqueEmail Property

 

Gets a value indicating whether an e-mail address stored on the Active Directory server must be unique.

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

public override bool RequiresUniqueEmail { get; }

Property Value

Type: System.Boolean

true if e-mail addresses must be unique; otherwise, false. The default is false.

Exception Condition
InvalidOperationException

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

When the RequiresUniqueEmail property is true, the ActiveDirectoryMembershipProvider instance ensures that the e-mail 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.

The following code example shows a Web.config entry that configures an ActiveDirectoryMembershipProvider instance to require unique e-mail 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>

.NET Framework
Available since 2.0
Return to top
Show: