DirectoryEntries.Find Método

Definição

Namespace:
System.DirectoryServices
Assembly:
System.DirectoryServices.dll
Pacote:
System.DirectoryServices v11.0.0-preview.5.26302.115

Retorna um membro desta coleção.

Sobrecargas

Nome Description
Find(String)

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

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

Retorna 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 para o qual pesquisar.

Retornos

DirectoryEntry

Um DirectoryEntry que representa o objeto filho que foi encontrado.

Exceções

InvalidOperationException

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

COMException

Ocorreu um erro durante a chamada para a interface subjacente.

Comentários

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

Note

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

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

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

Retorna o membro desta coleção com o nome especificado e o 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 de diretório filho para o qual pesquisar.

schemaClassName
String

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

Retornos

DirectoryEntry

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

Exceções

InvalidOperationException

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

COMException

Ocorreu um erro durante a chamada para a interface subjacente.

Exemplos

O exemplo a seguir cria um novo DirectoryEntry objeto com o caminho especificado, 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

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

Comentários

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

Aplica-se a