ActiveDirectoryMembershipProvider.EnableSearchMethods Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar ett värde som anger om sökorienterade ActiveDirectoryMembershipProvider metoder är tillgängliga.
public:
property bool EnableSearchMethods { bool get(); };
public bool EnableSearchMethods { get; }
member this.EnableSearchMethods : bool
Public ReadOnly Property EnableSearchMethods As Boolean
Egenskapsvärde
trueom sökmetoder är tillgängliga; annars . false Standardvärdet är false.
Undantag
Ett försök att komma åt EnableSearchMethods egenskapen gjordes innan instansen ActiveDirectoryMembershipProvider initierades.
Exempel
I följande kodexempel visas en Web.config post som konfigurerar en ActiveDirectoryMembershipProvider-instans för att aktivera sökning på en služba 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>
Kommentarer
Eftersom det kan vara resurskrävande att söka efter en služba Active Directory server kan egenskapen EnableSearchMethods inaktivera sökorienterade ActiveDirectoryMembershipProvider metoder. Egenskapen EnableSearchMethods anges i programmets konfigurationsfil med attributet enableSearchMethods för elementet membership Element (ASP.NET Settings Schema) element.
När egenskapen EnableSearchMethods är falseär följande metoder inte tillgängliga:
Providern använder en underträdssökning som börjar vid sökpunkten som anges i reťazec pripojenia. Mer information om anslutningssträngar finns i ActiveDirectoryMembershipProvider klassavsnittet.
Vi rekommenderar att du inte aktiverar sökning på produktionssystem förrän du har bekräftat att sökfrågorna som utfärdats av ActiveDirectoryMembershipProvider klassen inte påverkar katalogserverns prestanda negativt. ActiveDirectoryMembershipProvider Eftersom klassen är utformad för en tillståndslös webbmiljö kan den inte använda växlingsoptimeringarna som exponeras av de underliggande System.DirectoryServices API:erna. Det innebär att växlingsåtgärder vid sökningar mot stora kataloger är mycket dyra och bör undvikas. Sökåtgärder utfärdas alltid mot katalogservern som konfigurerats i reťazec pripojenia, eller en automatiskt vald server om en reťazec pripojenia pekar på en domän. Providern använder inte en global katalog för sina sökmetoder.