Bagikan melalui

ActiveDirectoryMembershipProvider.EnableSearchMethods Properti

  • Referensi

Definisi

Ruang nama:
System.Web.Security
Rakitan:
System.Web.dll

Mendapatkan nilai yang menunjukkan apakah metode berorientasi ActiveDirectoryMembershipProvider pencarian tersedia.

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

Nilai Properti

Boolean

true jika metode pencarian tersedia; jika tidak, false. Default adalah false.

Pengecualian

InvalidOperationException

Upaya untuk mengakses EnableSearchMethods properti dibuat sebelum ActiveDirectoryMembershipProvider instans diinisialisasi.

Contoh

Contoh kode berikut menunjukkan entri Web.config yang mengonfigurasi instans ActiveDirectoryMembershipProvider untuk mengaktifkan pencarian server Direktori Aktif.

<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>

Keterangan

Karena mencari server Direktori Aktif berpotensi intensif sumber daya, EnableSearchMethods properti memungkinkan Anda menonaktifkan metode berorientasi ActiveDirectoryMembershipProvider pencarian. Properti EnableSearchMethods diatur dalam file konfigurasi aplikasi Anda menggunakan enableSearchMethods atribut elemen Element keanggotaan (ASP.NET Settings Schema).

EnableSearchMethods Ketika properti adalah false, metode berikut tidak tersedia:

Penyedia menggunakan pencarian subtree mulai dari titik pencarian yang ditentukan dalam string koneksi. ActiveDirectoryMembershipProvider Lihat topik kelas untuk informasi selengkapnya tentang string koneksi.

Kami menyarankan agar Anda tidak mengaktifkan pencarian pada sistem produksi sampai Anda mengonfirmasi bahwa kueri pencarian yang dikeluarkan oleh ActiveDirectoryMembershipProvider kelas tidak berdampak buruk pada performa server direktori Anda. ActiveDirectoryMembershipProvider Karena kelas dirancang untuk lingkungan Web stateless, tidak dapat menggunakan pengoptimalan penomoran halaman yang diekspos oleh API yang mendasarSystem.DirectoryServices. Ini berarti bahwa operasi paging selama pencarian terhadap direktori besar sangat mahal dan harus dihindari. Operasi pencarian selalu dikeluarkan terhadap server direktori yang dikonfigurasi dalam string koneksi, atau server yang dipilih secara otomatis dalam kasus string koneksi yang menunjuk ke domain. Penyedia tidak menggunakan katalog global untuk metode pencariannya.

Berlaku untuk

Lihat juga