DirectoryEntries.Find Methode

Definition

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

Gibt ein Element dieser Auflistung zurück.

Überlädt

Name Beschreibung
Find(String)

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

Gibt das Element dieser Auflistung mit dem angegebenen Namen und dem angegebenen Typ zurück.

Find(String)

Gibt das Element 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 Objekt, das das gefundene untergeordnete Objekt darstellt.

Ausnahmen

InvalidOperationException

Das Active Directory Domain Services-Objekt ist kein Container.

COMException

Fehler beim Aufruf der zugrunde liegenden Schnittstelle.

Hinweise

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

Note

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 0x2030 ausgelöst.

Gilt für:

Find(String, String)

Gibt das Element dieser Auflistung mit dem angegebenen Namen und dem 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 Objekt darstellt.

Ausnahmen

InvalidOperationException

Das Active Directory Domain Services-Objekt ist kein Container.

COMException

Fehler beim Aufruf der zugrunde liegenden Schnittstelle.

Beispiele

Im folgenden Beispiel wird ein neues DirectoryEntry Objekt mit dem angegebenen Pfad erstellt und 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

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

Hinweise

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

Gilt für: