DirectorySearcher 類別

定義

命名空間:

System.DirectoryServices

組件:

System.DirectoryServices.dll

套件:

System.DirectoryServices v9.0.0-rc.2.24473.5

來源:

DirectorySearcher.cs

對 Active Directory Domain Services 執行查詢。

public ref class DirectorySearcher : System::ComponentModel::Component

public class DirectorySearcher : System.ComponentModel.Component

type DirectorySearcher = class
    inherit Component

Public Class DirectorySearcher
Inherits Component

繼承

Object

MarshalByRefObject

Component

DirectorySearcher

備註

使用 DirectorySearcher 物件，使用輕量型目錄存取通訊協定 （LDAP） 來搜尋及執行 Active Directory 網域服務階層的查詢。 LDAP 是唯一支援目錄搜尋的系統提供的 Active Directory 服務介面 （ADSI） 提供者。 系統管理員可以建立、改變和刪除階層中找到的物件。 如需詳細資訊，請參閱使用 System.DirectoryServices。

當您建立 DirectorySearcher實體時，您會指定要擷取的根目錄，以及要擷取的屬性選擇性清單。 SearchRoot 屬性可讓您設定其他屬性來執行下列工作：

• 快取本機電腦上的搜尋結果。 將 CacheResults 屬性設定為 true，以將目錄資訊儲存在本機計算機上。 只有在呼叫 DirectoryEntry.CommitChanges 方法時，才會更新此本機快取並認可至 Active Directory Domain Services。

• 使用 ServerTimeLimit 屬性指定搜尋的時間長度。

• 只擷取屬性名稱。 將 PropertyNamesOnly 屬性設定為 true，只擷取已指派值的屬性名稱。

• 執行分頁搜尋。 設定 PageSize 屬性，以指定分頁搜尋中傳回的物件數目上限。 如果您不想執行分頁搜尋，請將 PageSize 屬性設為預設值為零。

• 使用 SizeLimit 屬性，指定要傳回的項目數目上限。 如果您將 SizeLimit 屬性設為預設值為零，則伺服器決定的預設值為1000個專案。

注意

如果傳回的項目數目上限和時間限制超過伺服器上設定的限制，伺服器設定會覆寫元件設定。

如需 DirectorySearcher 類別實例的初始屬性值清單，請參閱 DirectorySearcher() 建構函式。

注意

假設您在使用此類別之前，已大致瞭解 Active Directory Domain Services。 如需詳細資訊，請參閱 System.DirectoryServices 概觀。

建構函式

DirectorySearcher()	使用預設值，初始化 DirectorySearcher 類別的新實例。
DirectorySearcher(DirectoryEntry, String, String[], SearchScope)	使用指定的搜尋根目錄、搜尋篩選、要擷取的屬性，以及搜尋範圍，初始化 DirectorySearcher 類別的新實例。
DirectorySearcher(DirectoryEntry, String, String[])	使用要擷取的指定搜尋根目錄、搜尋篩選和屬性，初始化 DirectorySearcher 類別的新實例。
DirectorySearcher(DirectoryEntry, String)	使用指定的搜尋根和搜尋篩選，初始化 DirectorySearcher 類別的新實例。
DirectorySearcher(DirectoryEntry)	使用指定的搜尋根目錄，初始化 DirectorySearcher 類別的新實例。
DirectorySearcher(String, String[], SearchScope)	使用指定的搜尋篩選、要擷取的屬性和搜尋範圍，初始化 DirectorySearcher 類別的新實例。
DirectorySearcher(String, String[])	使用要擷取的指定搜尋篩選和屬性，初始化 DirectorySearcher 類別的新實例。
DirectorySearcher(String)	使用指定的搜尋篩選，初始化 DirectorySearcher 類別的新實例。

屬性

Asynchronous	取得或設定值，這個值表示是否以異步方式執行搜尋。
AttributeScopeQuery	取得或設定要搜尋之辨別名稱屬性的LDAP顯示名稱。 只有一個屬性可用於這種類型的搜尋。
CacheResults	取得或設定值，指出是否在用戶端計算機上快取結果。
CanRaiseEvents	取得值，指出元件是否可以引發事件。 (繼承來源 Component)
ClientTimeout	取得或設定用戶端等候伺服器傳回結果的時間上限。 如果伺服器在此時間內沒有回應，則會中止搜尋，而且不會傳回任何結果。
Container	取得包含 Component的 IContainer。 (繼承來源 Component)
DerefAlias	取得或設定值，指出搜尋期間所找到對象的別名應該如何解析。
DesignMode	取得值，這個值表示 Component 目前是否處於設計模式。 (繼承來源 Component)
DirectorySynchronization	取得或設定 物件，表示要與搜尋搭配使用的目錄同步處理控件。
Events	取得附加至這個 Component之事件處理程序的清單。 (繼承來源 Component)
ExtendedDN	取得或設定值，這個值表示辨別名稱的格式。
Filter	取得或設定值，指出輕量型目錄存取通訊協定 （LDAP） 格式篩選字串。
PageSize	取得或設定值，指出分頁搜尋中的頁面大小。
PropertiesToLoad	取得值，指出搜尋期間要擷取的屬性清單。
PropertyNamesOnly	取得或設定值，指出搜尋是否只擷取已指派值的屬性名稱。
ReferralChasing	取得或設定值，指出轉介的追逐方式。
SearchRoot	取得或設定值，指出搜尋開始之 Active Directory 網域服務階層中的節點。
SearchScope	取得或設定值，指出伺服器觀察到的搜尋範圍。
SecurityMasks	取得或設定值，指出搜尋應該傳回指定屬性的安全性存取資訊。
ServerPageTimeLimit	取得或設定值，指出伺服器應該搜尋個別結果頁面的時間上限。 這與整個搜尋的時間限制不同。
ServerTimeLimit	ServerTimeLimit 屬性會取得或設定值，指出伺服器搜尋的時間上限。 如果達到時間限制，則只會傳回最多找到該點的專案。
Site	取得或設定 Component的 ISite。 (繼承來源 Component)
SizeLimit	取得或設定值，指出伺服器在搜尋中傳回的物件數目上限。
Sort	取得或設定值，指出排序結果的屬性。
Tombstone	取得或設定值，指出搜尋是否也應該傳回符合搜尋篩選條件的已刪除物件。
VirtualListView	取得或設定值，指出搜尋的虛擬清單檢視選項。

方法

CreateObjRef(Type)	建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 Component所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 DirectorySearcher 物件所使用的Managed資源，並選擇性地釋放 Unmanaged 資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FindAll()	執行搜尋，並傳回找到的專案集合。
FindOne()	執行搜尋，並只傳回找到的第一個專案。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個實例存留期原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	傳回 物件，表示 Component 或其 Container所提供的服務。 (繼承來源 Component)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個實例的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 對象的淺層複本。 (繼承來源 MarshalByRefObject)
ToString()	傳回包含 Component名稱的 String，如果有的話。 不應該覆寫這個方法。 (繼承來源 Component)

事件

Disposed

當呼叫 Dispose() 方法時，就會發生元件。 (繼承來源 Component)

另請參閱

• DirectoryEntries
• DirectoryEntry
• DirectorySearcher
• DirectorySearcher
• PropertyCollection
• PropertyValueCollection
• ReferralChasingOption
• SearchResultCollection
• SearchResult
• ResultPropertyValueCollection
• SearchScope
• SortDirection
• SortOption
• System.DirectoryServices