DirectoryEntries.Find Metodo

Definizione

Spazio dei nomi:
System.DirectoryServices
Assembly:
System.DirectoryServices.dll
Pacchetto:
System.DirectoryServices v11.0.0-preview.5.26302.115

Restituisce un membro dell'insieme.

Overload

Nome Descrizione
Find(String)

Restituisce il membro di questa raccolta con il nome specificato.
Find(String, String)

Restituisce il membro di questa raccolta con il nome e il tipo specificato.

Find(String)

Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs

Restituisce il membro di questa raccolta 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 in cui eseguire la ricerca.

Valori restituiti

DirectoryEntry

Oggetto DirectoryEntry che rappresenta l'oggetto figlio trovato.

Eccezioni

InvalidOperationException

L'oggetto Active Directory Domain Services 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.

Note

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 generata un'eccezione DirectoryServicesCOMException con codice di errore 0x2030.

Si applica a

Find(String, String)

Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs
Origine:
DirectoryEntries.cs

Restituisce il membro di questa raccolta con il nome e il tipo specificato.

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

Parametri

name
String

Nome dell'oggetto directory figlio in cui eseguire la ricerca.

schemaClassName
String

Nome della classe dell'oggetto directory figlio in cui eseguire la ricerca.

Valori restituiti

DirectoryEntry

Oggetto DirectoryEntry che rappresenta l'oggetto figlio trovato.

Eccezioni

InvalidOperationException

L'oggetto Active Directory Domain Services non è un contenitore.

COMException

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

Esempio

Nell'esempio seguente viene creato un nuovo DirectoryEntry oggetto con il percorso specificato, quindi viene creata una nuova voce nel contenitore e salvata. 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

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

Commenti

Se non viene trovato alcun risultato corrispondente, viene generata un'eccezione DirectoryServicesCOMException con codice di errore 0x2030.

Si applica a