PrincipalSearcher.FindOne メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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 一致がある場合、このメソッドは一致するプリンシパルのいずれかを任意に返します。

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