DirectorySearcher Třída

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Balíček:

System.DirectoryServices v8.0.0

Zdroj:

DirectorySearcher.cs

Provádí dotazy na 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

Dědičnost

Object

MarshalByRefObject

Component

DirectorySearcher

Poznámky

Pomocí objektu DirectorySearcher můžete vyhledávat a provádět dotazy v hierarchii Active Directory Domain Services pomocí protokolu LDAP (Lightweight Directory Access Protocol). LDAP je jediným systémem poskytovaným zprostředkovatelem rozhraní ADSI (Active Directory Service Interfaces), který podporuje vyhledávání adresářů. Správce může vytvářet, měnit a odstraňovat objekty, které se nacházejí v hierarchii. Další informace najdete v tématu Použití System.DirectoryServices.

Při vytváření instance DirectorySearchernástroje zadáte kořen, který chcete načíst, a volitelný seznam vlastností, které se mají načíst. Vlastnost SearchRoot umožňuje nastavit další vlastnosti pro následující úlohy:

• Výsledky hledání se ukládají do mezipaměti v místním počítači. Pokud chcete ukládat informace o adresáři CacheResults v místním počítači, nastavte vlastnost na true hodnotu . Aktualizace jsou provedeny do této místní mezipaměti a potvrzeny Active Directory Domain Services pouze při DirectoryEntry.CommitChanges zavolání metody.

• Zadejte dobu, po kterou se má hledat, pomocí ServerTimeLimit vlastnosti .

• Načíst pouze názvy atributů. PropertyNamesOnly Pokud chcete načíst pouze názvy atributů, kterým byly přiřazeny hodnoty, nastavte vlastnost na true hodnotu .

• Proveďte stránkované vyhledávání. PageSize Nastavením vlastnosti určete maximální počet objektů, které se vrátí při stránkovaném hledání. Pokud nechcete provádět stránkované vyhledávání, nastavte PageSize vlastnost na výchozí hodnotu nula.

• Zadejte maximální počet položek, které se mají vrátit, pomocí SizeLimit vlastnosti . Pokud vlastnost nastavíte SizeLimit na výchozí hodnotu nula, výchozí hodnota určená serverem je 1000 položek.

Poznámka

Pokud maximální počet vrácených položek a časové limity překročí omezení nastavená na serveru, nastavení serveru přepíše nastavení součásti.

Seznam počátečních hodnot vlastností pro instanci DirectorySearcher třídy naleznete v konstruktoru DirectorySearcher() .

Poznámka

Předpokládá se, že před použitím této třídy máte obecné znalosti Active Directory Domain Services. Další informace najdete v přehledu System.DirectoryServices .

Konstruktory

DirectorySearcher()	Inicializuje novou instanci třídy DirectorySearcher s výchozími hodnotami.
DirectorySearcher(DirectoryEntry)	Inicializuje novou instanci DirectorySearcher třídy pomocí zadaného kořenového adresáře vyhledávání.
DirectorySearcher(DirectoryEntry, String)	Inicializuje novou instanci DirectorySearcher třídy se zadaným vyhledávacím kořenem a vyhledávacím filtrem.
DirectorySearcher(DirectoryEntry, String, String[])	Inicializuje novou instanci DirectorySearcher třídy se zadaným kořenem vyhledávání, vyhledávacím filtrem a vlastnostmi k načtení.
DirectorySearcher(DirectoryEntry, String, String[], SearchScope)	Inicializuje novou instanci DirectorySearcher třídy se zadaným kořenem vyhledávání, vyhledávacím filtrem, vlastnostmi k načtení a oborem vyhledávání.
DirectorySearcher(String)	Inicializuje novou instanci DirectorySearcher třídy se zadaným vyhledávacím filtrem.
DirectorySearcher(String, String[])	Inicializuje novou instanci DirectorySearcher třídy se zadaným vyhledávacím filtrem a vlastnostmi k načtení.
DirectorySearcher(String, String[], SearchScope)	Inicializuje novou instanci DirectorySearcher třídy se zadaným vyhledávacím filtrem, vlastnostmi k načtení a oborem vyhledávání.

Vlastnosti

Asynchronous	Získá nebo nastaví hodnotu, která označuje, zda je vyhledávání provedeno asynchronně.
AttributeScopeQuery	Získá nebo nastaví zobrazovaný název LDAP rozlišující název atribut hledat v. Pro tento typ vyhledávání lze použít pouze jeden atribut.
CacheResults	Získá nebo nastaví hodnotu označující, zda je výsledek uložen v mezipaměti klientského počítače.
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
ClientTimeout	Získá nebo nastaví maximální dobu, po kterou klient čeká na server vrátit výsledky. Pokud server během této doby neodpoví, hledání se přeruší a nevrátí se žádné výsledky.
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
DerefAlias	Získá nebo nastaví hodnotu označující, jak by měly být vyřešeny aliasy objektů, které jsou nalezeny během hledání.
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
DirectorySynchronization	Získá nebo nastaví objekt, který představuje ovládací prvek synchronizace adresářů pro použití s vyhledáváním.
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
ExtendedDN	Získá nebo nastaví hodnotu, která označuje formát rozlišujících názvů.
Filter	Získá nebo nastaví hodnotu označující řetězec filtru formátu Ldap (Lightweight Directory Access Protocol).
PageSize	Získá nebo nastaví hodnotu označující velikost stránky v stránkovaném hledání.
PropertiesToLoad	Získá hodnotu označující seznam vlastností k načtení během hledání.
PropertyNamesOnly	Získá nebo nastaví hodnotu označující, zda hledání načte pouze názvy atributů, ke kterým byly přiřazeny hodnoty.
ReferralChasing	Získá nebo nastaví hodnotu označující, jak jsou referenční seznamy pronásledovány.
SearchRoot	Získá nebo nastaví hodnotu označující uzel v hierarchii Active Directory Domain Services, kde začíná hledání.
SearchScope	Získá nebo nastaví hodnotu označující obor vyhledávání, který je pozorován serverem.
SecurityMasks	Získá nebo nastaví hodnotu označující, které informace o zabezpečení přístupu pro zadané atributy by měly být vráceny hledáním.
ServerPageTimeLimit	Získá nebo nastaví hodnotu označující maximální dobu, po kterou by měl server vyhledat jednotlivé stránky výsledků. Toto není totéž jako časový limit pro celé hledání.
ServerTimeLimit	Vlastnost ServerTimeLimit získá nebo nastaví hodnotu označující maximální dobu, kterou server stráví hledáním. Při dosažení časového limitu se vrátí pouze položky, které byly nalezeny do tohoto okamžiku.
Site	Získá nebo nastaví ISite z Component. (Zděděno od Component)
SizeLimit	Získá nebo nastaví hodnotu označující maximální počet objektů, které server vrátí při hledání.
Sort	Získá nebo nastaví hodnotu označující vlastnost, podle které jsou výsledky seřazeny.
Tombstone	Získá nebo nastaví hodnotu označující, zda má hledání také vrátit odstraněné objekty, které odpovídají filtru hledání.
VirtualListView	Získá nebo nastaví hodnotu označující možnosti virtuálního zobrazení seznamu pro hledání.

Metody

CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní spravované prostředky, které objekt používá DirectorySearcher , a volitelně uvolní nespravované prostředky.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindAll()	Provede hledání a vrátí kolekci nalezených položek.
FindOne()	Provede hledání a vrátí pouze první nalezenou položku.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
ToString()	String Vrátí hodnotu obsahující název , Componentpokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed

Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)

Viz také

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