DirectorySearcher Třída

Reference

Definice

Obor názvů:: System.DirectoryServices

Sestavení:: System.DirectoryServices.dll

Balíček:: System.DirectoryServices v8.0.0

Balíček:: System.DirectoryServices v9.0.0-preview.4.24266.19

Zdroj:: DirectorySearcher.cs

Zdroj:: DirectorySearcher.cs

Zdroj:: DirectorySearcher.cs

Zdroj:: DirectorySearcher.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Provádí dotazy na službu Active Directory Domain Services.

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

public class DirectorySearcher : System.ComponentModel.Component

[System.DirectoryServices.DSDescription("DirectorySearcherDesc")]
public class DirectorySearcher : System.ComponentModel.Component

type DirectorySearcher = class
    inherit Component

[<System.DirectoryServices.DSDescription("DirectorySearcherDesc")>]
type DirectorySearcher = class
    inherit Component

Public Class DirectorySearcher
Inherits Component

Dědičnost: Object

MarshalByRefObject

Component
DirectorySearcher

Atributy: DSDescriptionAttribute

Poznámky

Pomocí objektu DirectorySearcher můžete vyhledávat a provádět dotazy v hierarchii služby Active Directory Domain Services pomocí protokolu LDAP (Lightweight Directory Access Protocol). LDAP je jediným systémem zadaným zprostředkovatelem rozhraní ACTIVE Directory Service Interfaces (ADSI), 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:

Ukládání výsledků hledání do mezipaměti v místním počítači. CacheResults Nastavte vlastnost na pro true ukládání informací o adresáři v místním počítači. Aktualizace této místní mezipaměti jsou provedeny a potvrzeny ve službě Active Directory Domain Services pouze v případě, že DirectoryEntry.CommitChanges je volána metoda.
Pomocí vlastnosti zadejte dobu hledání ServerTimeLimit .
Načtěte pouze názvy atributů. PropertyNamesOnly Nastavením vlastnosti na true načtěte pouze názvy atributů, ke kterým byly přiřazeny hodnoty.
Proveďte stránkované vyhledávání. PageSize Nastavte vlastnost tak, aby určila maximální počet objektů, které jsou vráceny 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.
Pomocí vlastnosti zadejte maximální počet vrácených SizeLimit položek. Pokud vlastnost nastavíte SizeLimit na výchozí hodnotu nula, výchozí hodnota určená serverem je 1 000 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 služby 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řenu 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, které se mají načíst.
DirectorySearcher(DirectoryEntry, String, String[], SearchScope)	Inicializuje novou instanci DirectorySearcher třídy se zadaným kořenem vyhledávání, vyhledávacím filtrem, vlastnostmi, které se mají načíst, a oborem hledání.
DirectorySearcher(String)	Inicializuje novou instanci DirectorySearcher třídy pomocí zadaného vyhledávacího filtru.
DirectorySearcher(String, String[])	Inicializuje novou instanci DirectorySearcher třídy se zadaným vyhledávacím filtrem a vlastnostmi, které se mají načíst.
DirectorySearcher(String, String[], SearchScope)	Inicializuje novou instanci DirectorySearcher třídy se zadaným vyhledávacím filtrem, vlastnostmi, které se mají načíst, a oborem hledání.

Vlastnosti

Asynchronous	Získá nebo nastaví hodnotu, která označuje, zda je vyhledávání provedeno asynchronně.
AttributeScopeQuery	Získá nebo nastaví ldap zobrazovaný název 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 v klientském počítači.
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á, než server vrátí 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 aliasy objektů, které jsou nalezeny během hledání by měly být vyřešeny.
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 protokolu 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í, které se mají načíst během hledání.
PropertyNamesOnly	Získá nebo nastaví hodnotu urč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 se referenční seznamy pronásledují.
SearchRoot	Získá nebo nastaví hodnotu označující uzel v hierarchii služby Active Directory Domain Services, kde začíná hledání.
SearchScope	Získá nebo nastaví hodnotu označující obor hledá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 hledat jednotlivé stránky výsledků. To 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í vyhledáváním. Pokud je dosaženo časového limitu, vrátí se pouze položky, které byly nalezeny do tohoto bodu.
Site	Získá nebo nastaví ISite hodnotu 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, na 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í vyhledávacímu filtru.
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 používaného 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()	Spustí hledání a vrátí kolekci nalezených položek.
FindOne()	Spustí hledání a vrátí pouze první nalezenou položku.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, 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 jejím Containerobjektem . (Zděděno od Component)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti, 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 Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed

Nastane, když je komponenta odstraněna voláním Dispose() metody.

(Zděděno od Component)

Platí pro

Sdílet prostřednictvím