DirectoryEntries.Find 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
回歸本收藏的成員之一。
多載
| 名稱 | Description |
|---|---|
| Find(String) |
回傳該集合中指定名稱的成員。 |
| Find(String, String) |
回傳該集合中具有指定名稱且類型的成員。 |
Find(String)
回傳該集合中指定名稱的成員。
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 DirectoryEntry參數
- name
- String
包含要搜尋的子物件名稱。
傳回
DirectoryEntry A 代表被發現的子物件。
例外狀況
Active Directory 網域服務 物件並非容器。
在呼叫底層介面時發生錯誤。
備註
若不同類型的子物件名稱相同，則會回傳第一個匹配的子物件。
Note
Internet Information Services（IIS）供應商不支援此方法。 使用超Find載方法，並為參數指定一個空字串（“”）。schemaClassName
若未找到匹配結果， DirectoryServicesCOMException 則拋出錯誤代碼0x2030。
適用於
Find(String, String)
回傳該集合中具有指定名稱且類型的成員。
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 DirectoryEntry參數
- name
- String
要搜尋的子目錄物件名稱。
- schemaClassName
- String
要搜尋的子目錄物件的類別名稱。
傳回
一個 DirectoryEntry 代表被發現子物件的物件。
例外狀況
Active Directory 網域服務 物件並非容器。
在呼叫底層介面時發生錯誤。
範例
以下範例會建立 DirectoryEntry 一個包含指定路徑的新物件，然後在容器中建立新項目並儲存。 它嘗試取回新建立的條目。
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);
}
}
}
備註
若未找到匹配結果， DirectoryServicesCOMException 則拋出錯誤代碼0x2030。
