ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Méthode

  • Référence

Définition

Espace de noms:
System.Web.Security
Assembly:
System.Web.dll

Obtient le nom d’utilisateur associé à l’adresse e-mail spécifiée.

public:
 override System::String ^ GetUserNameByEmail(System::String ^ email);
public override string GetUserNameByEmail (string email);
override this.GetUserNameByEmail : string -> string
Public Overrides Function GetUserNameByEmail (email As String) As String

Paramètres

email
String

l'adresse de messagerie à rechercher.

Retours

String

Nom d’utilisateur associé à l’adresse e-mail spécifiée.

Exceptions

ArgumentException

email dépasse 256 caractères.

- ou -

après ajustement, email est vide.

ProviderException

Plusieurs utilisateurs existent dans le magasin de données avec la même adresse e-mail et la propriété RequiresUniqueEmail a la valeur true.

InvalidOperationException

Le fournisseur n'est pas initialisé.

Remarques

Cette méthode est appelée par la Membership classe pour récupérer un nom d’utilisateur à partir du magasin de données Active Directory en fonction de l’adresse e-mail de l’utilisateur.

Si plusieurs utilisateurs du magasin de données d’appartenance ont la même adresse e-mail, le premier nom d’utilisateur rencontré est retourné. Vous pouvez définir l’attribut requiresUniqueEmail de l’élément membership Element (ASP.NET Settings Schema) sur true dans le fichier de configuration de l’application pour vous assurer que chaque adresse e-mail de la base de données est unique.

Les espaces à gauche et à droite sont retirés de la valeur de paramètre email. Si l’adresse e-mail est vide après la suppression, une ArgumentException est levée. Si l’adresse e-mail est null, tous les noms d’utilisateur du magasin de données Active Directory font l’objet d’une recherche et le premier nom d’utilisateur est retourné.

Nous vous recommandons de ne pas activer la recherche sur les systèmes de production tant que vous n’avez pas confirmé que les requêtes de recherche émises par la ActiveDirectoryMembershipProvider classe n’ont pas d’impact négatif sur les performances de votre serveur d’annuaire.

Important

La GetUserNameByEmail méthode s’exécute même lorsque la propriété a la EnableSearchMethods valeur false.

Étant donné que la ActiveDirectoryMembershipProvider classe est conçue pour un environnement Web sans état, elle ne peut pas utiliser les optimisations de pagination exposées par les API sous-jacentes System.DirectoryServices . Cela signifie que les opérations de pagination pendant les recherches sur des répertoires volumineux sont très coûteuses et doivent être évitées. Les opérations de recherche sont toujours émises sur le serveur d’annuaire configuré dans la chaîne de connexion, ou sur un serveur sélectionné automatiquement dans le cas d’une chaîne de connexion pointant vers un domaine. Le fournisseur n’utilise pas de catalogue global pour ses méthodes de recherche.

Le fournisseur utilise une recherche de sous-arborescence commençant au point de recherche spécifié dans la chaîne de connexion. Consultez la rubrique de ActiveDirectoryMembershipProvider classe pour plus d’informations sur les chaînes de connexion.

S’applique à

Voir aussi