DirectorySearcher.Filter 속성

  • 참조

정의

네임스페이스:
System.DirectoryServices
어셈블리:
System.DirectoryServices.dll

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

속성 값

String

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

특성
TypeConverterAttribute DSDescriptionAttribute SettingsBindableAttribute

설명

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

  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는 시간 차등이 없음을 의미합니다. 이 형식으로 "오전 10:20:00 1999년 5월 13일"은 "19990513102000Z"가 됩니다. Active Directory Domain Services 날짜와 시간을 협정 세계시(그리니치 표준시)로 저장합니다. 시간 차등 없이 시간을 지정하는 경우 GMT 시간으로 시간을 지정합니다.

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

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

적용 대상