DirectoryEntries.Find Methode

Definitie

Naamruimte:
System.DirectoryServices
Assembly:
System.DirectoryServices.dll
Pakket:
System.DirectoryServices v11.0.0-preview.4.26230.115

Hiermee wordt een lid van deze verzameling geretourneerd.

Overloads

Name Description
Find(String)

Retourneert het lid van deze verzameling met de opgegeven naam.
Find(String, String)

Retourneert het lid van deze verzameling met de opgegeven naam en van het opgegeven type.

Find(String)

Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs

Retourneert het lid van deze verzameling met de opgegeven naam.

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

Parameters

name
String

Bevat de naam van het onderliggende object waarvoor moet worden gezocht.

Retouren

DirectoryEntry

Een DirectoryEntry die het onderliggende object vertegenwoordigt dat is gevonden.

Uitzonderingen

InvalidOperationException

Het Active Directory Domain Services-object is geen container.

COMException

Er is een fout opgetreden tijdens het aanroepen van de onderliggende interface.

Opmerkingen

Als onderliggende objecten van verschillende typen dezelfde naam hebben, wordt het eerste overeenkomende onderliggende object geretourneerd.

Note

De provider Internet Information Services (IIS) biedt geen ondersteuning voor deze methode. Gebruik de overbelaste Find methode en geef een lege tekenreeks ("") op voor de schemaClassName parameter.

Als er geen overeenkomend resultaat wordt gevonden, wordt er een DirectoryServicesCOMException met foutcode 0x2030 gegenereerd.

Van toepassing op

Find(String, String)

Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs
Bron:
DirectoryEntries.cs

Retourneert het lid van deze verzameling met de opgegeven naam en van het opgegeven type.

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

Parameters

name
String

De naam van het onderliggende mapobject waarnaar moet worden gezocht.

schemaClassName
String

De klassenaam van het onderliggende mapobject waarnaar moet worden gezocht.

Retouren

DirectoryEntry

Een DirectoryEntry object dat het onderliggende object vertegenwoordigt dat is gevonden.

Uitzonderingen

InvalidOperationException

Het Active Directory Domain Services-object is geen container.

COMException

Er is een fout opgetreden tijdens het aanroepen van de onderliggende interface.

Voorbeelden

In het volgende voorbeeld wordt een nieuw DirectoryEntry object gemaakt met het opgegeven pad en wordt vervolgens een nieuwe vermelding in de container gemaakt en opgeslagen. Er wordt geprobeerd de zojuist gemaakte vermelding op te halen.

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

Opmerkingen

Als er geen overeenkomend resultaat wordt gevonden, wordt er een DirectoryServicesCOMException met foutcode 0x2030 gegenereerd.

Van toepassing op