DirectoryEntries.Find Método

Definição

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacote:

System.DirectoryServices v8.0.0

Retorna um membro dessa coleção.

Sobrecargas

Find(String)	Retorna o membro dessa coleção com o nome especificado.
Find(String, String)	Retorna o membro desta coleção com o nome especificado e do tipo especificado.

Find(String)

Origem:

DirectoryEntries.cs

Retorna o membro dessa coleção com o nome 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

Contém o nome do objeto filho a ser pesquisado.

Retornos

DirectoryEntry

Um DirectoryEntry que representa o objeto filho encontrado.

Exceções

InvalidOperationException

O objeto do Active Directory Domain Services não é um contêiner.

COMException

Erro durante a chamada à interface subjacente.

Comentários

Se objetos filho de tipos diferentes tiverem o mesmo nome, o primeiro objeto filho correspondente será retornado.

Observação

O provedor de Serviços de Informações da Internet (IIS) não dá suporte a esse método. Use o método sobrecarregado e especifique Find uma cadeia de caracteres vazia ("") para o schemaClassName parâmetro .

Se nenhum resultado correspondente for encontrado, um DirectoryServicesCOMException com código de erro 0x2030 será gerado.

Find(String, String)

Origem:

DirectoryEntries.cs

Retorna o membro desta coleção com o nome especificado e do 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

O nome do objeto de diretório filho a ser pesquisado.

schemaClassName

String

O nome de classe do objeto de diretório filho que será pesquisado.

Retornos

DirectoryEntry

Um objeto DirectoryEntry que representa o objeto filho encontrado.

Exceções

InvalidOperationException

O objeto do Active Directory Domain Services não é um contêiner.

COMException

Erro durante a chamada à interface subjacente.

Exemplos

O exemplo do .NET do Visual Basic a seguir cria um novo DirectoryEntry objeto com o caminho especificado e, em seguida, cria uma nova entrada no contêiner e o salva. Ele tenta recuperar a entrada recém-criada.

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  

O exemplo de C# a seguir mostra como criar um novo DirectoryEntry objeto com o caminho especificado e, em seguida, cria uma nova entrada no contêiner e o salva. Ele tenta recuperar a entrada recém-criada.

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

O exemplo C++ a seguir cria um novo DirectoryEntry objeto com o caminho especificado e, em seguida, cria uma nova entrada no contêiner e o salva. Ele tenta recuperar a nova 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);  
    }  
}  

Comentários

Se nenhum resultado correspondente for encontrado, um DirectoryServicesCOMException com código de erro 0x2030 será gerado.