ActiveDirectoryMembershipProvider.EnableSearchMethods Propriété

  • Référence

Définition

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

Obtient une valeur indiquant si les méthodes ActiveDirectoryMembershipProvider orientées recherche sont disponibles.

public:
 property bool EnableSearchMethods { bool get(); };
public bool EnableSearchMethods { get; }
member this.EnableSearchMethods : bool
Public ReadOnly Property EnableSearchMethods As Boolean

Valeur de propriété

Boolean

true si les méthodes de recherche sont disponibles ; sinon, false. La valeur par défaut est false.

Exceptions

InvalidOperationException

Une tentative d'accès à la propriété EnableSearchMethods a été effectuée avant l'initialisation de l'instance de ActiveDirectoryMembershipProvider.

Exemples

L’exemple de code suivant montre une entrée Web.config qui configure une instance pour activer la recherche d’un ActiveDirectoryMembershipProvider serveur Active Directory.

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

Remarques

Étant donné que la recherche d’un serveur Active Directory est potentiellement gourmande en ressources, la EnableSearchMethods propriété vous permet de désactiver les méthodes orientées ActiveDirectoryMembershipProvider recherche. La EnableSearchMethods propriété est définie dans le fichier de configuration de votre application à l’aide de l’attribut enableSearchMethods de l’élément d’appartenance (ASP.NET Paramètres Schema).

Lorsque la EnableSearchMethods propriété est false, les méthodes suivantes ne sont pas disponibles :

Le fournisseur utilise une recherche sous-arborescence à partir du point de recherche spécifié dans la chaîne de connexion. Pour plus d’informations sur les chaînes de connexion, consultez la ActiveDirectoryMembershipProvider rubrique de classe.

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. É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 les 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 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.

S’applique à

Voir aussi