DirectoryEntries.Find DirectoryEntries.Find DirectoryEntries.Find DirectoryEntries.Find Method

Definition

Gibt einen Member dieser Auflistung zurück.Returns a member of this collection.

Überlädt

Find(String) Find(String) Find(String) Find(String)

Gibt den Member dieser Auflistung mit dem angegebenen Namen zurück.Returns the member of this collection with the specified name.

Find(String, String) Find(String, String) Find(String, String) Find(String, String)

Gibt den Member dieser Auflistung mit dem angegebenen Namen und vom angegebenen Typ zurück.Returns the member of this collection with the specified name and of the specified type.

Find(String) Find(String) Find(String) Find(String)

Gibt den Member dieser Auflistung mit dem angegebenen Namen zurück.Returns the member of this collection with the specified name.

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

Parameter

name
String String String String

Enthält den Namen des untergeordneten Objekts, nach dem gesucht werden soll.Contains the name of the child object for which to search.

Gibt zurück

Ein DirectoryEntry, der das gefundene untergeordnete Element darstellt.A DirectoryEntry that represents the child object that was found.

Ausnahmen

Das Active Directory-Domänendienste-Objekt ist kein Container.The Active Directory Domain Services object is not a container.

Während des Aufrufs der zugrunde liegenden Schnittstelle ist ein Fehler aufgetreten.An error occurred during the call to the underlying interface.

Hinweise

Wenn untergeordnete Objekte verschiedener Typen denselben Namen aufweisen, wird das erste übereinstimmende untergeordnete Objekt zurückgegeben.If child objects of different types have the same name, the first matching child object is returned.

Hinweis

Der Internetinformationsdienste (IIS)-Anbieter unterstützt diese Methode nicht.The Internet Information Services (IIS) provider does not support this method. Verwenden Sie die Find überladene Methode, und geben Sie eine leere Zeichenfolge schemaClassName ("") für den Parameter an.Use the overloaded Find method and specify an empty string ("") for the schemaClassName parameter.

Wenn kein übereinstimmendes Ergebnis gefunden wird DirectoryServicesCOMException , wird ein mit dem Fehlercode 0x2030 ausgelöst.If no matching result is found, a DirectoryServicesCOMException with error code 0x2030 is thrown.

Find(String, String) Find(String, String) Find(String, String) Find(String, String)

Gibt den Member dieser Auflistung mit dem angegebenen Namen und vom angegebenen Typ zurück.Returns the member of this collection with the specified name and of the specified type.

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

Parameter

name
String String String String

Der Name des untergeordneten Verzeichnisobjekts, nach dem gesucht werden soll.The name of the child directory object for which to search.

schemaClassName
String String String String

Der Klassenname des untergeordneten Verzeichnisobjekts, nach dem gesucht werden soll.The class name of the child directory object for which to search.

Gibt zurück

Ein DirectoryEntry-Objekt, das das gefundene untergeordnete Element darstellt.A DirectoryEntry object that represents the child object that was found.

Ausnahmen

Das Active Directory-Domänendienste-Objekt ist kein Container.The Active Directory Domain Services object is not a container.

Während des Aufrufs der zugrunde liegenden Schnittstelle ist ein Fehler aufgetreten.An error occurred during the call to the underlying interface.

Beispiele

Im folgenden Visual Basic .NET-Beispiel wird ein DirectoryEntry neues-Objekt mit dem angegebenen Pfad erstellt. Anschließend wird ein neuer Eintrag im Container erstellt und gespeichert.The following Visual Basic .NET example creates a new DirectoryEntry object with the specified path, then creates a new entry in the container and saves it. Es wird versucht, den neu erstellten Eintrag abzurufen.It attempts to retrieve the newly created entry.

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  

Im folgenden C# Beispiel wird gezeigt, wie ein neues DirectoryEntry -Objekt mit dem angegebenen Pfad erstellt wird, anschließend wird ein neuer Eintrag im Container erstellt und gespeichert.The following C# example shows how to create a new DirectoryEntry object with the specified path, then creates a new entry in the container and saves it. Es wird versucht, den neu erstellten Eintrag abzurufen.It attempts to retrieve the newly- created entry.

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

Im folgenden C++ Beispiel wird ein neues DirectoryEntry -Objekt mit dem angegebenen Pfad erstellt. Anschließend wird ein neuer Eintrag im Container erstellt und gespeichert.The following C++ example creates a new DirectoryEntry object with the specified path, then creates a new entry in the container and saves it. Es wird versucht, den neuen Eintrag abzurufen.It attempts to retrieve the new entry.

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

Hinweise

Wenn kein übereinstimmendes Ergebnis gefunden wird DirectoryServicesCOMException , wird ein mit dem Fehlercode 0x2030 ausgelöst.If no matching result is found, a DirectoryServicesCOMException with error code 0x2030 is thrown.

Gilt für: