SearchResult.GetDirectoryEntry Method

Reference

Definition

Namespace:: System.DirectoryServices

Assembly:: System.DirectoryServices.dll

Package:: System.DirectoryServices v9.0.0

Source:: SearchResult.cs

Source:: SearchResult.cs

Source:: SearchResult.cs

Source:: SearchResult.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Retrieves the DirectoryEntry that corresponds to the SearchResult from the Active Directory Domain Services hierarchy.

public:
 System::DirectoryServices::DirectoryEntry ^ GetDirectoryEntry();

public System.DirectoryServices.DirectoryEntry GetDirectoryEntry ();

member this.GetDirectoryEntry : unit -> System.DirectoryServices.DirectoryEntry

Public Function GetDirectoryEntry () As DirectoryEntry

Returns

DirectoryEntry

The DirectoryEntry that corresponds to the SearchResult.

Examples

The following example is an excerpt of the example in SearchResult. The original example creates a new DirectoryEntry object with the desired path and uses the FindOne method to initiate the search. After performing the search, the example uses the GetDirectoryEntry method to retrieve the live directory entry that is identified in the search results.

' 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);

Remarks

Use GetDirectoryEntry when you want to look at the live entry instead of the entry that was returned through DirectorySearcher, or when you want to invoke a method on the object that was returned.

Note

Calling GetDirectoryEntry on each SearchResult returned through DirectorySearcher can be slow.

Applies to

Jaa