ActiveDirectoryMembershipProvider.EnableSearchMethods Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un valore che indica se i metodi orientati alla ricerca ActiveDirectoryMembershipProvider sono disponibili.
public:
property bool EnableSearchMethods { bool get(); };public bool EnableSearchMethods { get; }member this.EnableSearchMethods : boolPublic ReadOnly Property EnableSearchMethods As BooleanValore della proprietà
true se i metodi di ricerca sono disponibili; in caso contrario, false. Il valore predefinito è false.
Eccezioni
È stato effettuato un tentativo di accesso alla proprietà EnableSearchMethods prima che venisse effettuata l'inizializzazione dell'istanza della classe ActiveDirectoryMembershipProvider.
Esempio
Nell'esempio di codice seguente viene illustrata una voce Web.config che configura un'istanza ActiveDirectoryMembershipProvider per abilitare la ricerca di un server 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>
Commenti
Poiché la ricerca di un server Active Directory è potenzialmente intensivo di risorse, la EnableSearchMethods proprietà consente di disattivare metodi orientati ActiveDirectoryMembershipProvider alla ricerca. La EnableSearchMethods proprietà è impostata nel file di configurazione dell'applicazione usando l'attributo enableSearchMethodsdell'elemento membership (ASP.NET Settings Schema).
Quando la proprietà è false, i EnableSearchMethods metodi seguenti non sono disponibili:
Il provider usa una ricerca sottoalbero a partire dal punto di ricerca specificato nella stringa di connessione. Per altre informazioni sulle stringhe di connessione, vedere l'argomento ActiveDirectoryMembershipProvider della classe.
È consigliabile non abilitare la ricerca nei sistemi di produzione fino a quando non è stato confermato che le query di ricerca rilasciate dalla ActiveDirectoryMembershipProvider classe non influiscono negativamente sulle prestazioni del server directory. Poiché la ActiveDirectoryMembershipProvider classe è progettata per un ambiente Web senza stato, non è possibile usare le ottimizzazioni di paging esposte dalle API sottostanti System.DirectoryServices . Ciò significa che le operazioni di paging durante le ricerche su directory di grandi dimensioni sono molto costose e devono essere evitate. Le operazioni di ricerca vengono sempre rilasciate sul server directory configurato nella stringa di connessione oppure un server selezionato automaticamente nel caso di una stringa di connessione che punta a un dominio. Il provider non usa un catalogo globale per i metodi di ricerca.
