DirectoryEntries.Find Methode

  • Referenz

Definition

Namespace:
System.DirectoryServices
Assembly:
System.DirectoryServices.dll

Gibt einen Member dieser Auflistung zurück.

Überlädt

Find(String)

Gibt den Member dieser Auflistung mit dem angegebenen Namen zurück.
Find(String, String)

Gibt den Member dieser Auflistung mit dem angegebenen Namen und vom angegebenen Typ zurück.

Find(String)

Gibt den Member dieser Auflistung mit dem angegebenen Namen zurück.

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

Enthält den Namen des untergeordneten Objekts, nach dem gesucht werden soll.

Gibt zurück

DirectoryEntry

Ein DirectoryEntry, der das gefundene untergeordnete Element darstellt.

Ausnahmen

InvalidOperationException

Das Active Directory-Domänendienste-Objekt ist kein Container.

COMException

Während des Aufrufs der zugrunde liegenden Schnittstelle ist ein Fehler aufgetreten.

Hinweise

Wenn untergeordnete Objekte verschiedener Typen denselben Namen haben, wird das erste übereinstimmende untergeordnete Objekt zurückgegeben.

Hinweis

Der Internetinformationsdienste (IIS)-Anbieter unterstützt diese Methode nicht. Verwenden Sie die überladene Find Methode, und geben Sie eine leere Zeichenfolge ("") für den schemaClassName Parameter an.

Wenn kein übereinstimmende Ergebnis gefunden wird, wird ein DirectoryServicesCOMException Fehlercode ausgelöst, 0x2030 ausgelöst wird.

Gilt für

Find(String, String)

Gibt den Member dieser Auflistung mit dem angegebenen Namen und vom angegebenen Typ zurück.

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

Parameter

name
String

Der Name des untergeordneten Verzeichnisobjekts, nach dem gesucht werden soll.

schemaClassName
String

Der Klassenname des untergeordneten Verzeichnisobjekts, nach dem gesucht werden soll.

Gibt zurück

DirectoryEntry

Ein DirectoryEntry-Objekt, das das gefundene untergeordnete Element darstellt.

Ausnahmen

InvalidOperationException

Das Active Directory-Domänendienste-Objekt ist kein Container.

COMException

Während des Aufrufs der zugrunde liegenden Schnittstelle ist ein Fehler aufgetreten.

Beispiele

Im folgenden Visual Basic .NET-Beispiel wird ein neues Objekt mit dem angegebenen Pfad erstellt, und dann wird ein neuer DirectoryEntry Eintrag im Container erstellt und gespeichert. Es versucht, den neu erstellten Eintrag abzurufen.

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 Sie ein neues Objekt mit dem angegebenen Pfad erstellen und dann einen neuen DirectoryEntry Eintrag im Container erstellen und speichern. Es versucht, den neu erstellten Eintrag abzurufen.

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 Objekt mit dem angegebenen Pfad erstellt, und dann wird ein neuer DirectoryEntry Eintrag im Container erstellt und gespeichert. Es versucht, den neuen Eintrag abzurufen.

#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 übereinstimmende Ergebnis gefunden wird, wird ein DirectoryServicesCOMException Fehlercode ausgelöst, 0x2030 ausgelöst wird.

Gilt für