DirectoryEntries.Find Método

Definición

Espacio de nombres:

System.DirectoryServices

Ensamblado:

System.DirectoryServices.dll

Paquete:

System.DirectoryServices v8.0.0

Devuelve un miembro de esta colección.

Sobrecargas

Find(String)	Devuelve el miembro de esta colección con el nombre especificado.
Find(String, String)	Devuelve el miembro de esta colección con el nombre especificado y del tipo especificado.

Find(String)

Source:

DirectoryEntries.cs

Devuelve el miembro de esta colección con el nombre especificado.

public:
 System::DirectoryServices::DirectoryEntry ^ Find(System::String ^ name);

public System.DirectoryServices.DirectoryEntry Find (string name);

member this.Find : string -> System.DirectoryServices.DirectoryEntry

Public Function Find (name As String) As DirectoryEntry

Parámetros

name

String

Contiene el nombre del objeto secundario que se va a buscar.

Devoluciones

DirectoryEntry

DirectoryEntry que representa el objeto secundario encontrado.

Excepciones

InvalidOperationException

El objeto de Servicios de dominio de Active Directory no es un contenedor.

COMException

Se produjo un error durante la llamada a la interfaz subyacente.

Comentarios

Si los objetos secundarios de diferentes tipos tienen el mismo nombre, se devuelve el primer objeto secundario coincidente.

Nota

El proveedor de Internet Information Services (IIS) no admite este método. Use el método sobrecargado Find y especifique una cadena vacía ("") para el schemaClassName parámetro .

Si no se encuentra ningún resultado coincidente, se produce un DirectoryServicesCOMException código de error 0x2030.

Find(String, String)

Source:

DirectoryEntries.cs

Devuelve el miembro de esta colección con el nombre especificado y del tipo especificado.

public:
 System::DirectoryServices::DirectoryEntry ^ Find(System::String ^ name, System::String ^ schemaClassName);

public System.DirectoryServices.DirectoryEntry Find (string name, string? schemaClassName);

member this.Find : string * string -> System.DirectoryServices.DirectoryEntry

Public Function Find (name As String, schemaClassName As String) As DirectoryEntry

Parámetros

name

String

Nombre del objeto de directorio secundario que se va a buscar.

schemaClassName

String

Nombre de la clase del objeto de directorio secundario que se va a buscar.

Devoluciones

DirectoryEntry

Objeto DirectoryEntry que representa el objeto secundario encontrado.

Excepciones

InvalidOperationException

El objeto de Servicios de dominio de Active Directory no es un contenedor.

COMException

Se produjo un error durante la llamada a la interfaz subyacente.

Ejemplos

En el siguiente ejemplo de .NET de Visual Basic se crea un nuevo DirectoryEntry objeto con la ruta de acceso especificada y, a continuación, se crea una nueva entrada en el contenedor y se guarda. Intenta recuperar la entrada recién creada.

Try  
     Dim myEntry1 As DirectoryEntry  
     Dim myEntry2 As DirectoryEntry  
     Dim strPath As String = "LDAP://DC=fabrikam,DC=com"  

     ' Create a 'DirectoryEntry' object with the given path.  
     Dim myDE As New DirectoryEntry(strPath)  
     Dim myEntries As DirectoryEntries = myDE.Children  

     ' Create a new entry in the container.  
     myEntry1 = myEntries.Add("CN=Sample Entry", myDE.SchemaClassName)  
     ' Save changes in the 'Active Directory Domain Services' store.  
     myEntry1.CommitChanges()  

     ' Find a child in the 'DirectoryEntries' collection which has the   
     ' specified name and type.  
     myEntry2 = myEntries.Find("CN=Sample Entry", myDE.SchemaClassName)  
     Console.WriteLine(myEntry2.Name + " is found in container.")  

     Catch e As Exception  
          Console.WriteLine("The following exception was raised : {0}", e.Message.ToString())  
     End Try  

En el siguiente ejemplo de C# se muestra cómo crear un nuevo DirectoryEntry objeto con la ruta de acceso especificada y, a continuación, se crea una nueva entrada en el contenedor y se guarda. Intenta recuperar la entrada recién creada.

using System;  
using System.DirectoryServices;   

class MyClass1  
{  
   static void Main()  
   {  
      try  
      {          
         DirectoryEntry myEntry1;  
         DirectoryEntry myEntry2;  
         String strPath = "LDAP://DC=fabrikam,DC=com";  

         // Create a 'DirectoryEntry' object with the given path.  
         DirectoryEntry myDE = new DirectoryEntry(strPath);  
         DirectoryEntries myEntries = myDE.Children;  

         // Create a new entry in the container.  
         myEntry1 = myEntries.Add("CN=Sample Entry",myDE.SchemaClassName);  
         // Save changes in the 'Active Directory Domain Services' store.  
         myEntry1.CommitChanges();  

         // Find a child in the 'DirectoryEntries' collection which has the   
         // specified name and type.  
         myEntry2 = myEntries.Find("CN=Sample Entry",myDE.SchemaClassName);  
         Console.WriteLine (myEntry2.Name + " is found in container.");  

      }  
      catch(Exception e)  
      {  
         Console.WriteLine("The following exception was raised : {0}",e.Message);  
      }  
   }  
}  

En el siguiente ejemplo de C++ se crea un nuevo DirectoryEntry objeto con la ruta de acceso especificada y, a continuación, se crea una nueva entrada en el contenedor y se guarda. Intenta recuperar la nueva entrada.

#using <mscorlib.dll>  
#using <System.dll>  
#using <System.Directoryservices.dll>  

using namespace System;  
using namespace System::DirectoryServices;   

int main() {  
    try {          
        DirectoryEntry* myEntry1;  
        DirectoryEntry* myEntry2;  
        String* strPath = S"LDAP://DC=fabrikam,DC=com";  

        // Create a 'DirectoryEntry' object with the given path.  
        DirectoryEntry* myDE = new DirectoryEntry(strPath);  
        DirectoryEntries* myEntries = myDE->Children;  

        // Create a new entry in the container.  
        myEntry1 = myEntries->Add(S"CN=Sample Entry", myDE->SchemaClassName);  
        // Save changes in the 'Active Directory Domain Services' store.  
        myEntry1->CommitChanges();  

        // Find a child in the 'DirectoryEntries' collection which has the   
        // specified name and type.  
        myEntry2 = myEntries->Find(S"CN=Sample Entry", myDE->SchemaClassName);  
        Console::WriteLine ("{0} is found in container.", myEntry2->Name);  
    } catch(Exception* e) {  
        Console::WriteLine("The following exception was raised : {0}", e->Message);  
    }  
}  

Comentarios

Si no se encuentra ningún resultado coincidente, se produce un DirectoryServicesCOMException código de error 0x2030.