DirectorySearcher.Filter DirectorySearcher.Filter DirectorySearcher.Filter DirectorySearcher.Filter Property

Definition

Ruft einen Wert ab, der das Format der Filterzeichenfolge für LDAP (Lightweight Directory Access Protocol) angibt, oder legt diesen fest. Gets or sets a value indicating the Lightweight Directory Access Protocol (LDAP) format filter string.

public:
 property System::String ^ Filter { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.DirectoryServices.DSDescription("DSFilter")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Filter { get; set; }
member this.Filter : string with get, set
Public Property Filter As String

Eigenschaftswert

Die Zeichenfolge für den Suchfilter im LDAP-Format, beispielsweise "(objectClass=user)". The search filter string in LDAP format, such as "(objectClass=user)". Der Standard ist "(objectClass=*)", wodurch alle Objekte abgerufen werden. The default is "(objectClass=*)", which retrieves all objects.

Hinweise

Der Filter verwendet die folgenden Richtlinien:The filter uses the following guidelines:

  1. Die Zeichenfolge muss in Klammern eingeschlossen werden.The string must be enclosed in parentheses.

  2. Ausdrücke können die relationalen Operatoren verwenden: <, <=, =, > = und >.Expressions can use the relational operators: <, <=, =, >=, and >. Ein Beispiel hierfür ist "(objectClass=user)".An example is "(objectClass=user)". Ein weiteres Beispiel ist "(" LastName "> = Davis)".Another example is "(lastName>=Davis)".

  3. Zusammengesetzte Ausdrücke sind mit dem Präfixoperatoren gebildete & und |.Compound expressions are formed with the prefix operators & and |. Ein Beispiel ist "(&(objectClass=user) (" LastName "= Davis))".An example is "(&(objectClass=user)(lastName= Davis))". Ein weiteres Beispiel ist "(&(objectClass=Printer) (|(building=42)(building=43)))".Another example is "(&(objectClass=printer)(|(building=42)(building=43)))".

Wenn der Filter ein Attribut des ADS_UTC_TIME-Typs enthält, muss sein Wert im Format yyyymmddhhmmssZ aufweisen, in denen y "," m "," d "," h "," m, und "s jeweils für Jahr, Monat, Tag, Stunde, minute und Sekunde, bzw..When the filter contains an attribute of ADS_UTC_TIME type, its value must be of the yyyymmddhhmmssZ format where y, m, d, h, m, and s stand for year, month, day, hour, minute, and second, respectively. Der Wert für die Sekunden (ss) ist optional.The seconds (ss) value is optional. Die letzte Buchstaben Z bedeutet, es gibt keinen Zeitpunkt differenzielle.The final letter Z means there is no time differential. In diesem Format "10:20:00 UhrIn this format, "10:20:00 A.M. 13, möglicherweise 1999" wird"19990513102000Z".May 13, 1999" becomes "19990513102000Z". Beachten Sie, dass Active Directory Domain Services, das Datum und Uhrzeit als koordinierte Weltzeit (Greenwich Mean Time) gespeichert.Note that Active Directory Domain Services stores date and time as Coordinated Universal Time (Greenwich Mean Time). Wenn Sie einen Zeitraum ohne Zeitdifferenz angeben, legen Sie die Zeit in GMT-Zeit fest.If you specify a time with no time differential, you are specifying the time in GMT time.

Wenn Sie nicht in der Zeitzone der koordinierten Weltzeit sind, können Sie einen differenziellen Wert hinzufügen, um die Coordinated Universal Time (anstatt Z), eine Zeit Ihrer Zeitzone anzugeben.If you are not in the Coordinated Universal Time time zone, you can add a differential value to the Coordinated Universal Time (instead of specifying Z) to specify a time according to your time zone. Der differenziellen Sicherung wird basierend auf den folgenden: differenzielle = koordinierte Weltzeit - Local.The differential is based on the following: differential = Coordinated Universal Time- Local. Um eine differenzielle anzugeben, verwenden Sie das folgende Format: Yyyymmddhhmmss [+/-] Hhmm.To specify a differential, use the following format: yyyymmddhhmmss[+/-]hhmm. Z. B. "8:52:58 UhrFor example, "8:52:58 P.M. März 1999" Neuseeland Normalzeit (die Differenz beträgt 12 Stunden) als"19990323205258.0 + 1200"angegeben ist 23.March 23, 1999" New Zealand Standard Time (the differential is 12 hours) is specified as "19990323205258.0+1200".

Weitere Informationen zum Format LDAP-Suche finden Sie unter "Search Filter Syntax" in der MSDN Library unter http://msdn.microsoft.com/library .For more information about the LDAP search string format, see "Search Filter Syntax" in the MSDN Library at http://msdn.microsoft.com/library.

Gilt für: