PrincipalSearcher.QueryFilter Eigenschaft

Definition

Ruft den Abfragefilter ab, mit dem übereinstimmende Prinzipale gesucht werden, oder legt diesen fest.Gets or sets the query filter that is used to locate matching principals.

public:
 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

Eigenschaftswert

Das Principal -Objekt, das für die Abfrage verwendet null wird, oder, wenn kein Filter festgelegt ist.The Principal object that is used for the query or null if no filter is set.

Attribute

Ausnahmen

Beibehaltene Prinzipalobjekte können nicht als QueryFilter verwendet werden.Persisted Principal objects can not be used as the QueryFilter.

Der QueryFilter darf nicht null oder leer sein.The QueryFilter cannot be null or empty.

Hinweise

Das Prinzipal Objekt, das in dieser Eigenschaft enthalten ist, kann jeder Objekttyp sein, der von der Prinzipal Klasse abgeleitet ist: Computer, Benutzer oder Gruppe.The principal object contained in this property can be any type of object derived from the principal class: computer, user, or group. Kann QueryFilter auch ein erweiterter Prinzipaltyp sein, der durch PrincipalErweiterung von, UserPrincipal GroupPrincipal oder ComputerPrincipaldefiniert wird.The QueryFilter can also be an extended principal type that is defined by extending either Principal, UserPrincipal, GroupPrincipal or ComputerPrincipal. Der Typ des abgeleiteten Klassen Objekts, das an diese Eigenschaft übermittelt wird, bestimmt den Typ des abgefragten Objekts.The type of the derived class object that is passed to this property determines the type of object that is queried. Die resultierende Abfrage enthält ein logisches und aller Eigenschaften, die für das angegebene Prinzipal Objekt festgelegt sind.The resulting query contains a logical AND of all the properties set on the specified principal object. Weitere Informationen finden Sie im Übersichtsartikel Query by Example.For more information, see the Query by Example overview topic. Weitere Informationen zu den erweiterten Klassen finden Sie im Thema Übersicht über Prinzipal Erweiterungen .For more information on the extended classes, see the Principal Extensions overview topic.

Gilt für:

Siehe auch