DirectoryEntries.Find Metode

Definisi

Ruang nama:

System.DirectoryServices

Rakitan:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Mengembalikan anggota koleksi ini.

Overload

Find(String)	Mengembalikan anggota koleksi ini dengan nama yang ditentukan.
Find(String, String)	Mengembalikan anggota koleksi ini dengan nama yang ditentukan dan jenis yang ditentukan.

Find(String)

Sumber:

DirectoryEntries.cs

Mengembalikan anggota koleksi ini dengan nama yang ditentukan.

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

Parameter

name

String

Berisi nama objek anak yang akan dicari.

Mengembalikan

DirectoryEntry

DirectoryEntry yang mewakili objek anak yang ditemukan.

Pengecualian

InvalidOperationException

Objek Active Directory Domain Services bukan kontainer.

COMException

Terjadi kesalahan selama panggilan ke antarmuka yang mendasar.

Keterangan

Jika objek anak dari jenis yang berbeda memiliki nama yang sama, objek anak pertama yang cocok akan dikembalikan.

Catatan

Penyedia Layanan Informasi Internet (IIS) tidak mendukung metode ini. Gunakan metode kelebihan beban dan tentukan Find string kosong ("") untuk schemaClassName parameter .

Jika tidak ada hasil yang cocok yang ditemukan, DirectoryServicesCOMException kode kesalahan 0x2030 dilemparkan.

Find(String, String)

Sumber:

DirectoryEntries.cs

Mengembalikan anggota koleksi ini dengan nama yang ditentukan dan jenis yang ditentukan.

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

Parameter

name

String

Nama objek direktori anak yang akan dicari.

schemaClassName

String

Nama kelas objek direktori anak yang akan dicari.

Mengembalikan

DirectoryEntry

Objek DirectoryEntry yang mewakili objek anak yang ditemukan.

Pengecualian

InvalidOperationException

Objek Active Directory Domain Services bukan kontainer.

COMException

Terjadi kesalahan selama panggilan ke antarmuka yang mendasar.

Contoh

Contoh .NET Visual Basic berikut membuat objek baru DirectoryEntry dengan jalur yang ditentukan, lalu membuat entri baru dalam kontainer dan menyimpannya. Ini mencoba untuk mengambil entri yang baru dibuat.

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  

Contoh C# berikut menunjukkan cara membuat objek baru DirectoryEntry dengan jalur yang ditentukan, lalu membuat entri baru dalam kontainer dan menyimpannya. Ini mencoba untuk mengambil entri yang baru dibuat.

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

Contoh C++ berikut membuat objek baru DirectoryEntry dengan jalur yang ditentukan, lalu membuat entri baru dalam kontainer dan menyimpannya. Ini mencoba untuk mengambil entri baru.

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

Keterangan

Jika tidak ada hasil yang cocok yang ditemukan, DirectoryServicesCOMException kode kesalahan 0x2030 dilemparkan.