DirectoryEntries.Find メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このコレクションのメンバーを返します。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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 。
例外
Active Directory Domain Services オブジェクトはコンテナーではありません。
基になるインターフェイスの呼び出し中にエラーが発生しました。
注釈
異なる型の子オブジェクトの名前が同じである場合は、最初に一致する子オブジェクトが返されます。
Note
インターネット インフォメーション サービス (IIS) プロバイダーでは、このメソッドはサポートされていません。 オーバーロードされた Find メソッドを使用し、 schemaClassName パラメーターに空の文字列 ("") を指定します。
一致する結果が見つからない場合は、エラー コード0x2030を含む DirectoryServicesCOMException がスローされます。
適用対象
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 Domain Services オブジェクトはコンテナーではありません。
基になるインターフェイスの呼び出し中にエラーが発生しました。
例
次の例では、指定したパスを持つ新しい 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);
}
}
}
注釈
一致する結果が見つからない場合は、エラー コード0x2030を含む DirectoryServicesCOMException がスローされます。
