DirectoryEntries.Find Methode

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

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)

Quelle:

DirectoryEntries.cs

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 unterschiedlicher Typen denselben Namen haben, wird das erste übereinstimmende untergeordnete Objekt zurückgegeben.

Hinweis

Der Internetinformationsdienste-Anbieter (IIS) 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 eine DirectoryServicesCOMException mit dem Fehlercode 0x2030 ausgelöst.

Find(String, String)

Quelle:

DirectoryEntries.cs

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

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 DirectoryEntry -Objekt mit dem angegebenen Pfad erstellt, anschließend ein neuer 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  

Das folgende C#-Beispiel zeigt, wie Sie ein neues DirectoryEntry Objekt mit dem angegebenen Pfad erstellen, dann einen neuen 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 DirectoryEntry -Objekt mit dem angegebenen Pfad erstellt, dann ein neuer 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 eine DirectoryServicesCOMException mit dem Fehlercode 0x2030 ausgelöst.