PrincipalSearcher.FindOne メソッド

定義

QueryFilter プロパティで指定されたプリンシパルと一致することがわかった最初のプリンシパル オブジェクトが含まれるプリンシパル検索結果を返します。

public:
 System::DirectoryServices::AccountManagement::Principal ^ FindOne();
public System.DirectoryServices.AccountManagement.Principal FindOne ();
[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.Principal FindOne ();
member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal
[<System.Security.SecurityCritical>]
member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal
Public Function FindOne () As Principal

戻り値

Principalクエリ フィルターに一致するプリンシパル オブジェクトを含むオブジェクト。null結果が見つからない場合は 。

属性

例外

参照プロパティを格納する QueryFilter。 詳細については、「Query by Example」概要トピックを参照してください。

QueryFilter は、永続化されたプリンシパルです。

クエリを実行するには、最初に QueryFilter をプリンシパル サーチャーに割り当てる必要があります。

注釈

QueryFilter指定された オブジェクトの一致が 1 つだけある場合、このメソッドはそのオブジェクトを返します。 オブジェクトに複数の QueryFilter 一致がある場合、このメソッドは一致するプリンシパルの 1 つを任意に返します。

このメソッドから返されるオブジェクトは Principal 、 プロパティに含まれるオブジェクトの型と QueryFilter 一致します。 検索は、 プロパティで指定されたコンテキストで Context 実行されます。 詳細については、「Query by Example」概要トピックを参照してください。

適用対象

こちらもご覧ください