DirectorySearcher Třída
Definice
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 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
- Atributy
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() |
Zastaralé.
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() |
Zastaralé.
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) |
Platí pro
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro