DirectoryEntries.Find Metodo

Definizione

Spazio dei nomi:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacchetto:

System.DirectoryServices v8.0.0

Restituisce un membro dell'insieme.

Overload

Find(String)	Restituisce il membro dell'insieme con il nome specificato.
Find(String, String)	Restituisce il membro dell'insieme il cui nome e il cui tipo corrispondono a quelli specificati.

Find(String)

Origine:

DirectoryEntries.cs

Restituisce il membro dell'insieme con il nome specificato.

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

Parametri

name

String

Contiene il nome dell'oggetto figlio da ricercare.

Restituisce

DirectoryEntry

Oggetto DirectoryEntry che rappresenta l'oggetto figlio trovato.

Eccezioni

InvalidOperationException

L’oggetto dei Servizi di dominio Active Directory non è un contenitore.

COMException

Si è verificato un errore durante la chiamata all'interfaccia sottostante.

Commenti

Se gli oggetti figlio di tipi diversi hanno lo stesso nome, viene restituito il primo oggetto figlio corrispondente.

Nota

Il provider Internet Information Services (IIS) non supporta questo metodo. Usare il metodo di Find overload e specificare una stringa vuota ("") per il schemaClassName parametro.

Se non viene trovato alcun risultato corrispondente, viene generato un DirectoryServicesCOMException oggetto con codice di errore 0x2030.

Find(String, String)

Origine:

DirectoryEntries.cs

Restituisce il membro dell'insieme il cui nome e il cui tipo corrispondono a quelli specificati.

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

Parametri

name

String

Nome dell'oggetto directory figlio da ricercare.

schemaClassName

String

Nome della classe dell'oggetto directory figlio da ricercare.

Restituisce

DirectoryEntry

Oggetto DirectoryEntry che rappresenta l'oggetto figlio trovato.

Eccezioni

InvalidOperationException

L’oggetto dei Servizi di dominio Active Directory non è un contenitore.

COMException

Si è verificato un errore durante la chiamata all'interfaccia sottostante.

Esempio

L'esempio .NET di Visual Basic seguente crea un nuovo DirectoryEntry oggetto con il percorso specificato, quindi crea una nuova voce nel contenitore e la salva. Tenta di recuperare la voce appena creata.

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  

Nell'esempio C# seguente viene illustrato come creare un nuovo DirectoryEntry oggetto con il percorso specificato, quindi crea una nuova voce nel contenitore e la salva. Tenta di recuperare la voce appena creata.

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'esempio C++ seguente crea un nuovo DirectoryEntry oggetto con il percorso specificato, quindi crea una nuova voce nel contenitore e la salva. Tenta di recuperare la nuova voce.

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

Commenti

Se non viene trovato alcun risultato corrispondente, viene generato un DirectoryServicesCOMException oggetto con codice di errore 0x2030.