DirectoryEntries.Find Méthode

Définition

Espace de noms:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paquet:

System.DirectoryServices v8.0.0

Retourne un membre de cette collection.

Surcharges

Find(String)	Retourne le membre de cette collection avec le nom spécifié.
Find(String, String)	Retourne le membre de cette collection correspondant au nom et au type spécifiés.

Find(String)

Source:

DirectoryEntries.cs

Retourne le membre de cette collection avec le nom spécifié.

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

Paramètres

name

String

Contient le nom de l'objet enfant à rechercher.

Retours

DirectoryEntry

DirectoryEntry représentant l'objet enfant trouvé.

Exceptions

InvalidOperationException

L'objet des services de domaine Active Directory n'est pas un conteneur.

COMException

Une erreur s’est produite lors de l’appel d’une interface sous-jacente.

Remarques

Si des objets enfants de types différents ont le même nom, le premier objet enfant correspondant est retourné.

Notes

Le fournisseur IIS (Internet Information Services) ne prend pas en charge cette méthode. Utilisez la méthode surchargée Find et spécifiez une chaîne vide («  ») pour le schemaClassName paramètre.

Si aucun résultat correspondant n’est trouvé, une DirectoryServicesCOMException 0x2030 de code d’erreur est levée.

Find(String, String)

Source:

DirectoryEntries.cs

Retourne le membre de cette collection correspondant au nom et au type spécifiés.

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

Paramètres

name

String

Nom de l'objet annuaire enfant à rechercher.

schemaClassName

String

Nom de la classe de l'objet annuaire enfant à rechercher.

Retours

DirectoryEntry

Objet DirectoryEntry représentant l'objet enfant trouvé.

Exceptions

InvalidOperationException

L'objet des services de domaine Active Directory n'est pas un conteneur.

COMException

Une erreur s’est produite lors de l’appel d’une interface sous-jacente.

Exemples

L’exemple Visual Basic .NET suivant crée un DirectoryEntry objet avec le chemin spécifié, puis crée une entrée dans le conteneur et l’enregistre. Il tente de récupérer l’entrée nouvellement créée.

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  

L’exemple C# suivant montre comment créer un DirectoryEntry objet avec le chemin spécifié, puis créer une entrée dans le conteneur et l’enregistrer. Il tente de récupérer l’entrée nouvellement créée.

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

L’exemple C++ suivant crée un objet DirectoryEntry avec le chemin spécifié, puis crée une entrée dans le conteneur et l’enregistre. Il tente de récupérer la nouvelle entrée.

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

Remarques

Si aucun résultat correspondant n’est trouvé, une DirectoryServicesCOMException 0x2030 de code d’erreur est levée.