SearchResult.GetDirectoryEntry Método

Definición

Espacio de nombres:

System.DirectoryServices

Ensamblado:

System.DirectoryServices.dll

Paquete:

System.DirectoryServices v8.0.0

Source:

SearchResult.cs

Recupera el objeto DirectoryEntry que se corresponde con el objeto SearchResult de la jerarquía de Active Directory Domain Services.

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

public System.DirectoryServices.DirectoryEntry GetDirectoryEntry ();

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

Public Function GetDirectoryEntry () As DirectoryEntry

Devoluciones

DirectoryEntry

DirectoryEntry que se corresponde con SearchResult.

Ejemplos

El ejemplo siguiente es un extracto del ejemplo en SearchResult. En el ejemplo original se crea un nuevo DirectoryEntry objeto con la ruta de acceso deseada y se usa el FindOne método para iniciar la búsqueda. Después de realizar la búsqueda, en el ejemplo se usa el GetDirectoryEntry método para recuperar la entrada del directorio activo que se identifica en los resultados de la búsqueda.

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

Comentarios

Use GetDirectoryEntry cuando desee examinar la entrada dinámica en lugar de la entrada que se devolvió a través DirectorySearcherde , o cuando quiera invocar un método en el objeto devuelto.

Nota

Las llamadas GetDirectoryEntry en cada SearchResult devolución a través DirectorySearcher pueden ser lentas.