PrincipalSearcher.QueryFilter PrincipalSearcher.QueryFilter PrincipalSearcher.QueryFilter PrincipalSearcher.QueryFilter Property


一致するプリンシパルの特定に使用されるクエリ フィルターを取得または設定します。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


Principalクエリに使用されるオブジェクトまたはnullフィルターが設定されていない場合。The 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いずれかの拡張で定義されている拡張プリンシパル型を指定できますもPrincipalUserPrincipalGroupPrincipalまたはComputerPrincipalします。The 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.