PrincipalSearcher.QueryFilter プロパティ


一致するプリンシパルの特定に使用されるクエリ フィルターを取得または設定します。Gets or sets the query filter that is used to locate matching principals.

 property System::DirectoryServices::AccountManagement::Principal ^ QueryFilter { System::DirectoryServices::AccountManagement::Principal ^ get(); void set(System::DirectoryServices::AccountManagement::Principal ^ value); };
[get: System.Security.SecurityCritical]
[set: System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.Principal QueryFilter { get; set; }
member this.QueryFilter : System.DirectoryServices.AccountManagement.Principal with get, set
Public Property QueryFilter As Principal


クエリに使用されるnull オブジェクト。フィルターが設定されていない場合は。PrincipalThe Principal object that is used for the query or null if no filter is set.



永続化されたプリンシパル オブジェクトは、QueryFilter として使用できません。Persisted Principal objects can not be used as the QueryFilter.

QueryFilter は、null または空にはできません。The QueryFilter cannot be null or empty.


このプロパティに格納されているプリンシパルオブジェクトには、プリンシパルクラスから派生した任意の型のオブジェクト (コンピューター、ユーザー、またはグループ) を指定できます。The principal object contained in this property can be any type of object derived from the principal class: computer, user, or group. QueryFilter 、、 UserPrincipalPrincipalまたはComputerPrincipalのいずれかを拡張することによって定義される拡張プリンシパル型にすることもできます。 GroupPrincipalThe QueryFilter can also be an extended principal type that is defined by extending either Principal, UserPrincipal, GroupPrincipal or ComputerPrincipal. このプロパティに渡される派生クラスオブジェクトの型によって、クエリ対象のオブジェクトの型が決まります。The type of the derived class object that is passed to this property determines the type of object that is queried. 結果として得られるクエリには、指定されたプリンシパルオブジェクトに設定されているすべてのプロパティの論理 AND が含まれています。The resulting query contains a logical AND of all the properties set on the specified principal object. 詳細については、「Query by Example」概要トピックを参照してください。For more information, see the Query by Example overview topic. 拡張クラスの詳細については、「プリンシパル拡張機能の概要」を参照してください。For more information on the extended classes, see the Principal Extensions overview topic.