DirectorySearcher Třída

Definice

Obor názvů:: System.DirectoryServices

Sestavení:: System.DirectoryServices.dll

Balíček:: System.DirectoryServices v11.0.0-preview.2.26159.112

Zdroj:: DirectorySearcher.cs

Zdroj:: DirectorySearcher.cs

Zdroj:: DirectorySearcher.cs

Zdroj:: DirectorySearcher.cs

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 vůči službě 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 na hierarchii služby Active Directory Domain Services pomocí protokolu LDAP (Lightweight Directory Access Protocol). LDAP je jediný poskytovatel rozhraní služby Active Directory Service Interfaces (ADSI), který podporuje vyhledávání adresářů. Správce může provádět, měnit a odstraňovat objekty nalezené v hierarchii. Další informace naleznete v tématu Použití System.DirectoryServices.

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

Výsledky hledání můžete uložit do mezipaměti na místním počítači. CacheResults Nastavte vlastnost tak, aby true ukládaly informace o adresáři v místním počítači. Aktualizace jsou provedeny v této místní mezipaměti a potvrzeny do služby Active Directory Domain Services pouze v případě, DirectoryEntry.CommitChanges že je volána metoda.
Zadejte dobu, po kterou se má hledat, pomocí ServerTimeLimit vlastnosti.
Umožňuje načíst pouze názvy atributů. PropertyNamesOnly Nastavte vlastnost tak, aby true načítala 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čil maximální počet objektů, které jsou vráceny v stránkované 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, je výchozí hodnota určená serverem 1000 položek.

Poznámka:

Pokud maximální počet vrácených položek a časových limitů 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 máte obecné znalosti služby Active Directory Domain Services před použitím této třídy. Další informace najdete v přehledu System.DirectoryServices .

Konstruktory

Name	Description
DirectorySearcher()	Inicializuje novou instanci DirectorySearcher třídy s výchozími hodnotami.
DirectorySearcher(DirectoryEntry, String, String[], SearchScope)	Inicializuje novou instanci DirectorySearcher třídy se zadaným kořenem vyhledávání, vyhledávacím filtrem, vlastnostmi pro načtení a oborem vyhledávání.
DirectorySearcher(DirectoryEntry, String, String[])	Inicializuje novou instanci DirectorySearcher třídy se zadaným kořenem vyhledávání, filtrem vyhledávání a vlastnostmi, které se mají načíst.
DirectorySearcher(DirectoryEntry, String)	Inicializuje novou instanci DirectorySearcher třídy se zadaným kořenem vyhledávání a vyhledávacím filtrem.
DirectorySearcher(DirectoryEntry)	Inicializuje novou instanci DirectorySearcher třídy pomocí zadaného kořenového adresáře vyhledávání.
DirectorySearcher(String, String[], SearchScope)	Inicializuje novou instanci DirectorySearcher třídy se zadaným vyhledávacím filtrem, vlastnostmi pro načtení a obor vyhledávání.
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)	Inicializuje novou instanci DirectorySearcher třídy se zadaným vyhledávacím filtrem.

Vlastnosti

Name	Description
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 atributu rozlišujícího názvu pro vyhledávání. Pro tento typ vyhledávání lze použít pouze jeden atribut.
CacheResults	Získá nebo nastaví hodnotu určující, zda je výsledek uložen v mezipaměti v klientském počítači.
CanRaiseEvents	Získá hodnotu urč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á ten IContainer , který obsahuje Component. (Zděděno od Component)
DerefAlias	Získá nebo nastaví hodnotu určující, jak mají být vyřešeny aliasy objektů nalezených během hledání.
DesignMode	Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (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 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 jsou referenční seznamy pronásledovány.
SearchRoot	Získá nebo nastaví hodnotu označující uzel v hierarchii služby Active Directory Domain Services, kde se vyhledávání spouští.
SearchScope	Získá nebo nastaví hodnotu označující rozsah hledání, který je pozorován serverem.
SecurityMasks	Získá nebo nastaví hodnotu určující, které informace o zabezpečení přístupu pro zadané atributy mají být vráceny vyhledává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í stejné jako časový limit pro celé vyhledávání.
ServerTimeLimit	Vlastnost ServerTimeLimit získá nebo nastaví hodnotu označující maximální dobu, po kterou server stráví hledáním. Pokud je dosaženo časového limitu, vrátí se pouze položky nalezené až do tohoto bodu.
Site	Získá nebo nastaví ISite .Component (Zděděno od Component)
SizeLimit	Získá nebo nastaví hodnotu označující maximální počet objektů, které server vrátí ve vyhledávání.
Sort	Získá nebo nastaví hodnotu označující vlastnost, pro kterou jsou výsledky seřazeny.
Tombstone	Získá nebo nastaví hodnotu určující, zda by hledání mělo vrátit odstraněné objekty, které odpovídají vyhledávacímu filtru.
VirtualListView	Získá nebo nastaví hodnotu označující možnosti zobrazení virtuálního seznamu pro hledání.

Metody

Name	Description
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužící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čuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FindAll()	Spustí vyhledávání a vrátí kolekci nalezených položek.
FindOne()	Provede vyhledávání a vrátí pouze první nalezenou položku.
GetHashCode()	Slouží jako výchozí funkce hash. (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 jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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

Name	Description
Disposed	Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?