DirectorySearcher Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Utför frågor mot Doménové služby Active Directory.
public ref class DirectorySearcher : System::ComponentModel::Componentpublic class DirectorySearcher : System.ComponentModel.Component[System.DirectoryServices.DSDescription("DirectorySearcherDesc")]
public class DirectorySearcher : System.ComponentModel.Componenttype DirectorySearcher = class
inherit Component[<System.DirectoryServices.DSDescription("DirectorySearcherDesc")>]
type DirectorySearcher = class
inherit ComponentPublic Class DirectorySearcher
Inherits Component- Arv
- Attribut
Kommentarer
Använd ett DirectorySearcher-objekt för att söka efter och köra frågor mot en Doménové služby Active Directory-hierarki med hjälp av Lightweight Directory Access Protocol (LDAP). LDAP är den enda adsi-providern (system-provided služba Active Directory Service Interfaces) som stöder katalogsökning. En administratör kan skapa, ändra och ta bort objekt som finns i hierarkin. Mer information finns i Använda System.DirectoryServices.
När du skapar en instans av DirectorySearcheranger du den rot som du vill hämta och en valfri lista med egenskaper som ska hämtas. Med SearchRoot egenskapen kan du ange ytterligare egenskaper för att utföra följande uppgifter:
Cachelagra sökresultaten på den lokala datorn. Ange egenskapen CacheResults till
trueför att lagra kataloginformation på den lokala datorn. Uppdateringar görs i den här lokala cachen och skickas endast till Doménové služby Active Directory när metoden DirectoryEntry.CommitChanges anropas.Ange hur lång tid det tar att söka med hjälp av ServerTimeLimit egenskapen .
Hämta endast attributnamn. Ange egenskapen PropertyNamesOnly till
trueför att endast hämta namnen på attribut som värden har tilldelats till.Utför en växlingssökning. Ange egenskapen PageSize för att ange det maximala antalet objekt som returneras i en sidsökning. Om du inte vill utföra en växlingssökning anger du PageSize egenskapen till standardvärdet noll.
Ange det maximala antalet poster som ska returneras med hjälp av SizeLimit egenskapen . Om du anger SizeLimit egenskapen till standardvärdet noll är den serverdefinierade standardinställningen 1 000 poster.
Note
Om det maximala antalet returnerade poster och tidsgränser överskrider de begränsningar som anges på servern åsidosätter serverinställningarna komponentinställningarna.
En lista över initiala egenskapsvärden för en instans av DirectorySearcher klassen finns i DirectorySearcher() konstruktorn.
Note
Det förutsätts att du har en allmän förståelse för Doménové služby Active Directory innan du använder den här klassen. Mer information finns i översikten System.DirectoryServices .
Konstruktorer
| Name | Description |
|---|---|
| DirectorySearcher() |
Initierar en ny instans av DirectorySearcher klassen med standardvärden. |
| DirectorySearcher(DirectoryEntry, String, String[], SearchScope) |
Initierar en ny instans av DirectorySearcher klassen med den angivna sökroten, sökfiltret, egenskaper som ska hämtas och sökomfånget. |
| DirectorySearcher(DirectoryEntry, String, String[]) |
Initierar en ny instans av DirectorySearcher klassen med den angivna sökroten, sökfiltret och egenskaperna som ska hämtas. |
| DirectorySearcher(DirectoryEntry, String) |
Initierar en ny instans av DirectorySearcher klassen med det angivna sökrots- och sökfiltret. |
| DirectorySearcher(DirectoryEntry) |
Initierar en ny instans av klassen med hjälp av DirectorySearcher den angivna sökroten. |
| DirectorySearcher(String, String[], SearchScope) |
Initierar en ny instans av DirectorySearcher klassen med det angivna sökfiltret, egenskaper som ska hämtas och sökomfånget. |
| DirectorySearcher(String, String[]) |
Initierar en ny instans av DirectorySearcher klassen med det angivna sökfiltret och egenskaperna som ska hämtas. |
| DirectorySearcher(String) |
Initierar en ny instans av DirectorySearcher klassen med det angivna sökfiltret. |
Egenskaper
| Name | Description |
|---|---|
| Asynchronous |
Hämtar eller anger ett värde som anger om sökningen utförs asynkront. |
| AttributeScopeQuery |
Hämtar eller anger LDAP-visningsnamnet för det unika namnattributet som ska sökas in. Endast ett attribut kan användas för den här typen av sökning. |
| CacheResults |
Hämtar eller anger ett värde som anger om resultatet cachelagras på klientdatorn. |
| CanRaiseEvents |
Hämtar ett värde som anger om komponenten kan generera en händelse. (Ärvd från Component) |
| ClientTimeout |
Hämtar eller anger den maximala tid som klienten väntar på att servern ska returnera resultat. Om servern inte svarar inom den här tiden avbryts sökningen och inga resultat returneras. |
| Container |
Hämtar som IContainer innehåller Component. (Ärvd från Component) |
| DerefAlias |
Hämtar eller anger ett värde som anger hur aliasen för objekt som hittas under en sökning ska matchas. |
| DesignMode |
Hämtar ett värde som anger om det Component för närvarande är i designläge. (Ärvd från Component) |
| DirectorySynchronization |
Hämtar eller anger ett objekt som representerar katalogsynkroniseringskontrollen som ska användas med sökningen. |
| Events |
Hämtar listan över händelsehanterare som är kopplade till den här Component. (Ärvd från Component) |
| ExtendedDN |
Hämtar eller anger ett värde som anger formatet för de unika namnen. |
| Filter |
Hämtar eller anger ett värde som anger LDAP-formatfiltersträngen (Lightweight Directory Access Protocol). |
| PageSize |
Hämtar eller anger ett värde som anger sidstorleken i en sidsökning. |
| PropertiesToLoad |
Hämtar ett värde som anger listan över egenskaper som ska hämtas under sökningen. |
| PropertyNamesOnly |
Hämtar eller anger ett värde som anger om sökningen endast hämtar namnen på attribut som värden har tilldelats till. |
| ReferralChasing |
Hämtar eller anger ett värde som anger hur hänvisningar jagas. |
| SearchRoot |
Hämtar eller anger ett värde som anger noden i Doménové služby Active Directory-hierarkin där sökningen startar. |
| SearchScope |
Hämtar eller anger ett värde som anger sökomfånget som observeras av servern. |
| SecurityMasks |
Hämtar eller anger ett värde som anger vilken säkerhetsåtkomstinformation för de angivna attributen som ska returneras av sökningen. |
| ServerPageTimeLimit |
Hämtar eller anger ett värde som anger den maximala tiden som servern ska söka efter en enskild resultatsida. Det här är inte samma som tidsgränsen för hela sökningen. |
| ServerTimeLimit |
Egenskapen ServerTimeLimit hämtar eller anger ett värde som anger den maximala tid som servern ägnar åt att söka. Om tidsgränsen nås returneras endast poster som hittas fram till den punkten. |
| Site |
Hämtar eller ställer in ISite i Component. (Ärvd från Component) |
| SizeLimit |
Hämtar eller anger ett värde som anger det maximala antalet objekt som servern returnerar i en sökning. |
| Sort |
Hämtar eller anger ett värde som anger den egenskap som resultatet sorteras på. |
| Tombstone |
Hämtar eller anger ett värde som anger om sökningen också ska returnera borttagna objekt som matchar sökfiltret. |
| VirtualListView |
Hämtar eller anger ett värde som anger visningsalternativen för den virtuella listan för sökningen. |
Metoder
| Name | Description |
|---|---|
| CreateObjRef(Type) |
Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject) |
| Dispose() |
Släpper alla resurser som används av Component. (Ärvd från Component) |
| Dispose(Boolean) |
Frigör de hanterade resurser som används av DirectorySearcher objektet och, om du vill, frigör ohanterade resurser. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| FindAll() |
Kör sökningen och returnerar en samling poster som hittas. |
| FindOne() |
Kör sökningen och returnerar bara den första posten som hittas. |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetLifetimeService() |
Föråldrad.
Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| GetService(Type) |
Returnerar ett objekt som representerar en tjänst som tillhandahålls av Component eller av dess Container. (Ärvd från Component) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| InitializeLifetimeService() |
Föråldrad.
Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| MemberwiseClone(Boolean) |
Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject) |
| ToString() |
Returnerar ett String som innehåller namnet på Component, om det finns. Den här metoden bör inte åsidosättas. (Ärvd från Component) |
Händelser
| Name | Description |
|---|---|
| Disposed |
Inträffar när komponenten tas bort av ett anrop till Dispose() metoden. (Ärvd från Component) |
