ActiveDirectoryMembershipProvider.EnableSearchMethods Properti

Referensi

Definisi

Ruang nama:: System.Web.Security

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

Pengantar Keanggotaan ASP.NET

Bagikan melalui