DirectoryEntries.Find Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Source:
- DirectoryEntries.cs
- 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.DirectoryEntryPublic Function Find (name As String) As DirectoryEntryParamètres
- name
- String
Contient le nom de l'objet enfant à rechercher.
Retours
DirectoryEntry représentant l'objet enfant trouvé.
Exceptions
L'objet des services de domaine Active Directory n'est pas un conteneur.
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.
S’applique à
Find(String, String)
- Source:
- DirectoryEntries.cs
- Source:
- DirectoryEntries.cs
- 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);public System.DirectoryServices.DirectoryEntry Find (string name, string? schemaClassName);member this.Find : string * string -> System.DirectoryServices.DirectoryEntryPublic Function Find (name As String, schemaClassName As String) As DirectoryEntryParamètres
- name
- String
Nom de l'objet annuaire enfant à rechercher.
- schemaClassName
- String
Nom de la classe de l'objet annuaire enfant à rechercher.
Retours
Objet DirectoryEntry représentant l'objet enfant trouvé.
Exceptions
L'objet des services de domaine Active Directory n'est pas un conteneur.
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.
