This documentation is archived and is not being maintained.

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 Value

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

ExceptionCondition
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 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: