SearchResult.GetDirectoryEntry-Methode

Ruft den DirectoryEntry ab, der dem SearchResult aus der Active Directory-Hierarchie entspricht.

Namespace: System.DirectoryServices
Assembly: System.DirectoryServices (in system.directoryservices.dll)

Syntax

'Declaration
Public Function GetDirectoryEntry As DirectoryEntry
'Usage
Dim instance As SearchResult
Dim returnValue As DirectoryEntry

returnValue = instance.GetDirectoryEntry

public DirectoryEntry GetDirectoryEntry ()

public:
DirectoryEntry^ GetDirectoryEntry ()

public DirectoryEntry GetDirectoryEntry ()

public function GetDirectoryEntry () : DirectoryEntry

Rückgabewert

Der DirectoryEntry, der dem SearchResult entspricht.

Hinweise

Verwenden Sie GetDirectoryEntry, wenn Sie den tatsächlichen Eintrag anstelle des von DirectorySearcher zurückgegebenen Eintrags anzeigen oder eine Methode für ein zurückgegebenes Objekt abrufen möchten.

Hinweis

Das Aufrufen von GetDirectoryEntry für jedes von DirectorySearcher zurückgegebene SearchResult kann zeitaufwändig sein.

Beispiel

Das folgende Beispiel ist ein Auszug aus dem Beispiel in SearchResult. Im ursprünglichen Beispiel wird ein neues DirectoryEntry-Objekt mit dem gewünschten Pfad erstellt und die FindOne-Methode verwendet, um die Suche zu starten. Nach dem Ausführen des Suchvorgangs wird im Beispiel die GetDirectoryEntry-Methode verwendet, um den in den Suchergebnissen identifizierten tatsächlichen Verzeichniseintrag abzurufen.

' Get the 'DirectoryEntry' that corresponds to 'mySearchResult'.
Dim myDirectoryEntry As DirectoryEntry = mySearchResult.GetDirectoryEntry()
Console.WriteLine(ControlChars.Newline + "The name of the 'myDirectoryEntry' " + _
            "directory entry that corresponds to the " + _
            "'mySearchResult' search result is : {0}" + _
            ControlChars.Newline, myDirectoryEntry.Name)

// Get the 'DirectoryEntry' that corresponds to 'mySearchResult'.
DirectoryEntry myDirectoryEntry = 
                           mySearchResult.GetDirectoryEntry();
Console.WriteLine("\nThe name of the 'myDirectoryEntry' " +
                  "directory entry that corresponds to the " +
                  "'mySearchResult' search result is : {0}\n",
                  myDirectoryEntry.Name);

// Get the 'DirectoryEntry' that corresponds to 'mySearchResult'.
DirectoryEntry^ myDirectoryEntry = mySearchResult->GetDirectoryEntry();
Console::WriteLine(
    String::Concat("\nThe name of the 'myDirectoryEntry' ",
    "directory entry that corresponds to the ",
    "'mySearchResult' search result is : {0}\n"),
    myDirectoryEntry->Name);

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

SearchResult-Klasse
SearchResult-Member
System.DirectoryServices-Namespace