DirectorySearcher.Filter 속성

정의

LDAP(Lightweight Directory Access Protocol) 형식의 필터 문자열을 나타내는 값을 가져오거나 설정합니다.

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

속성 값

"(objectClass=user)"와 같은 LDAP 형식의 검색 필터 문자열입니다. 기본값은 모든 개체 검색을 나타내는 "(objectClass=*)"입니다.

특성

설명

필터는 다음 지침을 사용합니다.

  1. 문자열은 괄호로 묶어야 합니다.

  2. 식은 관계형 연산<자 , <=, =, =, >>및 를 사용할 수 있습니다. 예를 들어 "(objectClass=user)"가 있습니다. 또 다른 예는 "(lastName>=Davis)"입니다.

  3. 복합 식은 및 |& 접두사 연산자를 사용하여 형성됩니다. 예를 들어 "(&(objectClass=user)(lastName= Davis))"가 있습니다. 또 다른 예는 "(&(objectClass=printer)(|( building=42)(building=43))".

필터에 ADS_UTC_TIME 형식의 특성이 포함된 경우 해당 값은 yyyymmddhhmmssZ 형식이어야 합니다. 여기서 y, m, d, h, m 및 s는 각각 연도, 월, 일, 시간, 분 및 초를 나타냅니다. 초(ss) 값은 선택 사항입니다. 마지막 문자 Z는 시간 차등이 없음을 의미합니다. 이 형식에서 "1999년 5월 13일 오전 10:20:00"은 "19990513102000Z"가 됩니다. Active Directory Domain Services 날짜와 시간을 협정 세계시(그리니치 표준시)로 저장합니다. 시간 차등 없이 시간을 지정하는 경우 GMT 시간으로 시간을 지정합니다.

협정 세계 표준 시간대에 있지 않은 경우 Z를 지정하는 대신 협정 세계시(협정 세계시)에 차등 값을 추가하여 표준 시간대에 따라 시간을 지정할 수 있습니다. 차등은 차등 = 협정 세계시- 로컬을 기반으로합니다. 차등을 지정하려면 yyyymmdddhhmmss[+/-]hhmm 형식을 사용합니다. 예를 들어 "1999년 3월 23일 오후 8시 52분 58분" 뉴질랜드 표준시(차등은 12시간)는 "19990323205258.0+1200"으로 지정됩니다.

LDAP 검색 문자열 형식에 대한 자세한 내용은 필터 구문 Search 참조하세요.

적용 대상