DirectorySearcher 類別 (System.DirectoryServices)

.NET Framework 類別庫

DirectorySearcher 類別

更新：2007 年 11 月

對 Active Directory 執行查詢。

命名空間： System.DirectoryServices
組件： System.DirectoryServices (在 System.DirectoryServices.dll 中)

語法

Visual Basic (宣告)

<DSDescriptionAttribute("DirectorySearcherDesc")> _
<DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted := True)> _
Public Class DirectorySearcher _
    Inherits Component

Visual Basic (使用方式)

Dim instance As DirectorySearcher

[DSDescriptionAttribute("DirectorySearcherDesc")]
[DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true)]
public class DirectorySearcher : Component

Visual C++

[DSDescriptionAttribute(L"DirectorySearcherDesc")]
[DirectoryServicesPermissionAttribute(SecurityAction::LinkDemand, Unrestricted = true)]
public ref class DirectorySearcher : public Component

/** @attribute DSDescriptionAttribute("DirectorySearcherDesc") */
/** @attribute DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true) */
public class DirectorySearcher extends Component

JScript

public class DirectorySearcher extends Component

備註

使用 DirectorySearcher 物件，以對使用輕量型目錄存取協定 (LDAP) 的 Active Directory 階層架構進行搜尋和執行查詢。LDAP 是唯一由系統提供的 Active Directory Service Interfaces (ADSI) 提供者，其支援目錄搜尋。系統管理員可以建立、修改和刪除階層架構中找到的物件。如需詳細資訊，請參閱使用 System.DirectoryServices。

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

快取本機電腦上的搜尋結果。將 CacheResults 屬性設為 true 來存放本機電腦上的目錄資訊。只有在呼叫 DirectoryEntry..::.CommitChanges 方法時，本機快取才會進行更新並認可到 Active Directory。
使用 ServerTimeLimit 屬性指定搜尋的時間長度。
只擷取屬性名稱。將 PropertyNamesOnly 屬性設為 true，只擷取已經指派值的屬性名稱。
執行分頁搜尋。設定 PageSize 屬性，以指定在分頁搜尋中傳回之物件的最大數目。如果您不要執行分頁搜尋，請將 PageSize 屬性設為其預設的零值。
使用 SizeLimit 屬性，指定要傳回之項目的最大數目。如果將 SizeLimit 屬性設為其預設的零值，則伺服器決定的預設值為 1000 個項目。

注意事項：
如果傳回之項目的最大數目和時間限制超過伺服器所設定的限制，則伺服器設定值會覆寫元件設定值。

如需 DirectorySearcher 類別之執行個體的初始屬性值清單，請參閱 DirectorySearcher()()() 建構函式。

注意事項：
它假設您在使用這個類別之前已對 Active Directory 網域服務有一般性瞭解。如需詳細資訊，請參閱 System.DirectoryServices 概觀。

使用權限

DirectoryServicesPermission
LinkDemand

繼承階層架構

System..::.Object
  System..::.MarshalByRefObject
    System.ComponentModel..::.Component
      System.DirectoryServices..::.DirectorySearcher

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

平台

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。

版本資訊