ActiveDirectoryMembershipProvider.EnableSearchMethods ActiveDirectoryMembershipProvider.EnableSearchMethods ActiveDirectoryMembershipProvider.EnableSearchMethods ActiveDirectoryMembershipProvider.EnableSearchMethods Property

Definición

Obtiene un valor que indica si están disponibles los métodos ActiveDirectoryMembershipProvider orientados a búsqueda.Gets a value indicating whether search-oriented ActiveDirectoryMembershipProvider methods are available.

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

Valor de propiedad

true si están disponibles los métodos de búsqueda; de lo contrario, false.true if search methods are available; otherwise, false. De manera predeterminada, es false.The default is false.

Excepciones

Se ha intentado obtener acceso a la propiedad EnableSearchMethods antes de inicializar la instancia de ActiveDirectoryMembershipProvider.An attempt to access the EnableSearchMethods property was made before the ActiveDirectoryMembershipProvider instance was initialized.

Ejemplos

En el ejemplo de código siguiente se muestra una entrada de Web.config que configura un ActiveDirectoryMembershipProvider instancia para habilitar la búsqueda de un servidor de Active Directory.The following code example shows a Web.config entry that configures an ActiveDirectoryMembershipProvider instance to enable searching an 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"  
          enableSearchMethods="true" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>  

Comentarios

Porque la búsqueda de un servidor de Active Directory es potencialmente consume recursos, el EnableSearchMethods propiedad le permite desactivar orientados a búsqueda ActiveDirectoryMembershipProvider métodos.Because searching an Active Directory server is potentially resource intensive, the EnableSearchMethods property enables you to turn off search-oriented ActiveDirectoryMembershipProvider methods. El EnableSearchMethods propiedad está establecida en configuración de la aplicación de archivos mediante el enableSearchMethods atributo de la pertenencia Element (ASP.NET Settings Schema) elemento.The EnableSearchMethods property is set in your application's configuration file using the enableSearchMethods attribute of the membership Element (ASP.NET Settings Schema) element.

Cuando el EnableSearchMethods propiedad es false, no están disponibles los siguientes métodos:When the EnableSearchMethods property is false, the following methods are not available:

El proveedor usa una búsqueda de subárbol comenzando en el punto de búsqueda especificado en la cadena de conexión.The provider uses a subtree search starting at the search point specified in the connection string. Vea el ActiveDirectoryMembershipProvider tema para obtener más información acerca de las cadenas de conexión de la clase.See the ActiveDirectoryMembershipProvider class topic for more information about connection strings.

Se recomienda que no habilite la búsqueda en los sistemas de producción hasta que haya confirmado que las consultas de búsqueda emiten por la ActiveDirectoryMembershipProvider clase no afectan negativamente al rendimiento del servidor de directorio.We recommend that you do not enable searching on production systems until you have confirmed that the search queries issued by the ActiveDirectoryMembershipProvider class do not adversely impact your directory server's performance. Puesto que la ActiveDirectoryMembershipProvider clase está diseñada para un entorno Web sin estado, no puede utilizar las optimizaciones de paginación expuestas por subyacente System.DirectoryServices API.Since the ActiveDirectoryMembershipProvider class is designed for a stateless Web environment, it is unable to use the paging optimizations exposed by the underlying System.DirectoryServices APIs. Esto significa que las operaciones de paginación durante las búsquedas en los directorios grandes son muy costosas y deben evitarse.This means that paging operations during searches against large directories are very expensive and should be avoided. Las operaciones de búsqueda siempre se emiten en el servidor de directorio configurado en la cadena de conexión o un servidor seleccionado automáticamente en el caso de una cadena de conexión que señala a un dominio.Search operations are always issued against the directory server configured in the connection string, or an automatically selected server in the case of a connection string pointing at a domain. El proveedor no utiliza un catálogo global para sus métodos de búsqueda.The provider does not use a global catalog for its search methods.

Se aplica a

Consulte también: