ActiveDirectoryMembershipProvider.EnableSearchMethods 속성

정의

네임스페이스:

System.Web.Security

어셈블리:

System.Web.dll

검색 지향 ActiveDirectoryMembershipProvider 메서드를 사용할 수 있는지 여부를 나타내는 값을 가져옵니다.

public:
 property bool EnableSearchMethods { bool get(); };

public bool EnableSearchMethods { get; }

member this.EnableSearchMethods : bool

Public ReadOnly Property EnableSearchMethods As Boolean

속성 값

Boolean

검색 메서드를 사용할 수 있으면 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다.

예외

InvalidOperationException

EnableSearchMethods 인스턴스가 초기화되기 전에 ActiveDirectoryMembershipProvider 속성에 액세스하려고 한 경우

예제

다음 코드 예제에서는 Active Directory 서버를 검색할 수 있도록 인스턴스를 ActiveDirectoryMembershipProvider 구성하는 Web.config 항목을 보여 줍니다.

<configuration>
  <connectionStrings>
    <add name="ADService" connectionString="LDAP://ldapServer/" />
  </connectionStrings>
  <system.web>
    <membership defaultProvider="AspNetActiveDirectoryMembershipProvider">
      <providers>
        <add name="AspNetActiveDirectoryMembershipProvider"
          type="System.Web.Security.ActiveDirectoryMembershipProvider,
          System.Web, Version=2.0.3600, Culture=neutral,
          PublicKeyToken=b03f5f7f11d50a3a"
          enableSearchMethods="true" />
      </providers>
    </membership>
  </system.web>
</configuration>

설명

Active Directory 서버 검색은 리소스를 많이 사용할 EnableSearchMethods 수 있으므로 속성을 사용하면 검색 지향 ActiveDirectoryMembershipProvider 메서드를 해제할 수 있습니다. EnableSearchMethods 애플리케이션의 구성에서 속성을 설정할 사용 하 여 파일를 enableSearchMethods 특성을 membership 요소 (ASP.NET 설정 스키마) 요소.

속성이 인 EnableSearchMethods 경우 false다음 메서드를 사용할 수 없습니다.

• FindUsersByName

• FindUsersByEmail

• GetAllUsers

공급자는 연결 문자열에 지정된 검색 지점에서 시작하는 하위 트리 검색을 사용합니다. 연결 문자열에 ActiveDirectoryMembershipProvider 대한 자세한 내용은 클래스 항목을 참조하세요.

클래스에서 발급 ActiveDirectoryMembershipProvider 한 검색 쿼리가 디렉터리 서버의 성능에 부정적인 영향을 미치지 않는지 확인할 때까지 프로덕션 시스템에서 검색을 사용하도록 설정하지 않는 것이 좋습니다. ActiveDirectoryMembershipProvider 클래스는 상태 비저장 웹 환경을 위해 설계되었으므로 기본 API에서 노출하는 페이징 최적화를 System.DirectoryServices 사용할 수 없습니다. 즉, 큰 디렉터리를 검색하는 동안 페이징 작업은 비용이 많이 들고 피해야 합니다. 검색 작업은 항상 연결 문자열에 구성된 디렉터리 서버 또는 도메인을 가리키는 연결 문자열의 경우 자동으로 선택된 서버에 대해 실행됩니다. 공급자는 검색 방법에 전역 카탈로그를 사용하지 않습니다.

추가 정보

• ASP.NET 멤버 자격 소개