DirectoryEntries.Find Método

Definição

Espaço de Nomes:
System.DirectoryServices
Assemblagem:
System.DirectoryServices.dll
Pacote:
System.DirectoryServices v11.0.0-preview.4.26230.115

Retorna um membro desta coleção.

Sobrecargas

Name Description
Find(String)

Devolve o membro desta coleção com o nome especificado.
Find(String, String)

Devolve o membro desta coleção com o nome especificado e do tipo especificado.

Find(String)

Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs

Devolve o membro desta 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 que deve procurar.

Devoluções

DirectoryEntry

A DirectoryEntry que representa o objeto filho que foi encontrado.

Exceções

InvalidOperationException

O objeto Active Directory Domain Services não é um contentor.

COMException

Ocorreu um erro durante a chamada para a interface subjacente.

Observações

Se objetos filhos de diferentes tipos tiverem o mesmo nome, o primeiro objeto filho correspondente é devolvido.

Note

O fornecedor do Serviços de Informação Internet (IIS) não suporta este método. Use o método sobrecarregado Find e especifique uma cadeia vazia ("") para o schemaClassName parâmetro.

Se não for encontrado um resultado correspondente, é lançado um DirectoryServicesCOMException 0x2030 com código de erro.

Aplica-se a

Find(String, String)

Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs
Origem:
DirectoryEntries.cs

Devolve 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);
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 diretório filho que deve procurar.

schemaClassName
String

O nome da classe do objeto diretório filho para o qual pesquisar.

Devoluções

DirectoryEntry

Um DirectoryEntry objeto que representa o objeto filho que foi encontrado.

Exceções

InvalidOperationException

O objeto Active Directory Domain Services não é um contentor.

COMException

Ocorreu um erro durante a chamada para a interface subjacente.

Exemplos

O exemplo seguinte cria um novo DirectoryEntry objeto com o caminho especificado, depois cria uma nova entrada no contentor e guarda-a. 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

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

Observações

Se não for encontrado um resultado correspondente, é lançado um DirectoryServicesCOMException 0x2030 com código de erro.

Aplica-se a