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)

'Declaration
Public Overrides ReadOnly Property RequiresUniqueEmail As Boolean
'Usage
Dim instance As ActiveDirectoryMembershipProvider
Dim value As Boolean

value = instance.RequiresUniqueEmail

/** @property */
public boolean get_RequiresUniqueEmail ()

public override function get RequiresUniqueEmail () : boolean

Not applicable.

Property Value

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

Exception typeCondition

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>

Windows 98, Windows Server 2000 SP4, 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.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: