DirectoryEntries.Find Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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)
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.DirectoryEntryPublic Function Find (name As String) As DirectoryEntryParámetros
- name
- String
Contiene el nombre del objeto secundario que se va a buscar.
Devoluciones
DirectoryEntry que representa el objeto secundario encontrado.
Excepciones
El objeto de Servicios de dominio de Active Directory no es un contenedor.
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 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.
Se aplica a
Find(String, String)
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);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
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
Objeto DirectoryEntry que representa el objeto secundario encontrado.
Excepciones
El objeto de Servicios de dominio de Active Directory no es un contenedor.
Se produjo un error durante la llamada a la interfaz subyacente.
Ejemplos
El siguiente ejemplo de Visual Basic .NET crea un nuevo DirectoryEntry objeto con la ruta de acceso especificada y, a continuación, crea una nueva entrada en el contenedor y la 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 ejemplo de C# siguiente 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 ejemplo de C++ siguiente 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.