DirectoryEntries.Find Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- DirectoryEntries.cs
- 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.DirectoryEntryPublic Function Find (name As String) As DirectoryEntryParâmetros
- name
- String
Contém o nome do objeto filho a ser pesquisado.
Retornos
Um DirectoryEntry que representa o objeto filho encontrado.
Exceções
O objeto do Active Directory Domain Services não é um contêiner.
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.
Aplica-se a
Find(String, String)
- Origem:
- DirectoryEntries.cs
- Origem:
- DirectoryEntries.cs
- 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);public System.DirectoryServices.DirectoryEntry Find (string name, string? schemaClassName);member this.Find : string * string -> System.DirectoryServices.DirectoryEntryPublic Function Find (name As String, schemaClassName As String) As DirectoryEntryParâ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
Um objeto DirectoryEntry que representa o objeto filho encontrado.
Exceções
O objeto do Active Directory Domain Services não é um contêiner.
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.
