roleManager의 providers 요소에 대한 add 요소(ASP.NET 설정 스키마)

아티클
08/09/2011

역할 관리 공급자의 컬렉션에 역할 공급자 인스턴스를 추가합니다.

이 요소는 .NET Framework 버전 2.0에서 새로 도입되었습니다.

<add name="provider name" 
     type="string"
     connectionStringName="string"
     applicationName="string" 
     commandTimeout="number" 
     description="string" 
     cacheRefreshInterval="number" 
     scopeName="string"/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
applicationName	선택적 String 특성입니다. 데이터 소스에서 역할 이름이 저장되는 응용 프로그램의 이름을 지정합니다. 응용 프로그램 이름을 사용하면 다른 응용 프로그램을 사용할 때마다 중복 역할 이름이 나타나는 일 없이 여러 ASP.NET 응용 프로그램에서 동일한 데이터베이스를 사용할 수 있습니다. 또는 동일한 응용 프로그램 이름을 지정하여 여러 ASP.NET 응용 프로그램에서 동일한 역할 정보를 사용할 수 있습니다. 이 특성을 지정하지 않으면 .NET Framework에 포함된 역할 공급자는 ApplicationName 속성에 대해 ApplicationVirtualPath 값을 사용합니다.
cacheRefreshInterval	선택적 Int32 특성입니다. 캐시된 정책 저장소 데이터의 업데이트 간격(분)을 지정하고 AuthorizationStoreRoleProvider에만 적용됩니다. 기본값은 60입니다.
commandTimeout	선택적 Int32 특성입니다. 역할 관리자 데이터 소스에 대해 실행되는 명령이 시간 초과되기 전의 시간(초)을 지정합니다. 이 제한 시간은 SQL 공급자가 SqlCommand 개체를 만들 때 사용됩니다. 기본적으로 이 특성은 ASP.NET 구성에 설정되어 있지 않습니다. ADO.NET 기본값인 30초가 사용됩니다. 이 특성을 설정하면 SQL 공급자는 데이터베이스에 대해 실행되는 모든 SQL 명령에 해당 제한 시간 값을 사용합니다. 기본값은 30(ADO.NET 기본값)입니다.
connectionStringName	필수 String 특성입니다. <connectionStrings> 요소에 정의된 연결 문자열의 이름을 지정합니다. 지정된 연결 문자열은 추가되는 공급자에 사용됩니다.
description	선택적 String 특성입니다. 역할 공급자 인스턴스에 대한 설명을 지정합니다.
name	필수 String 특성입니다. 공급자 인스턴스의 이름을 지정합니다. 이 값은 공급자 인스턴스를 기본 역할 공급자로 식별하기 위해 <roleManager> 요소의 defaultProvider 특성에 사용됩니다. 또한 공급자 name은 Providers 컬렉션에서 공급자의 인덱스를 만드는 데 사용됩니다.
scopeName	선택적 String 특성입니다. 공급자 인스턴스에서 연결할 권한 부여 관리자 정책 저장소의 보안 범위를 지정하고 AuthorizationStoreRoleProvider에만 적용됩니다. scopeName이 지정되면 정책 저장소에 연결할 때 applicationName과 scopeName의 조합이 공급자에 사용됩니다.
type	필수 String 특성입니다. RoleProvider 추상 기본 클래스를 구현하는 형식을 지정합니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.
system.web	ASP.NET 구성 섹션의 루트 요소를 지정합니다.
roleManager	역할 관리에 대한 응용 프로그램을 구성합니다.
providers	역할 관리에 대한 역할 공급자의 컬렉션을 정의합니다.

설명

add 요소는 providers 요소에 저장된 역할 관리 공급자 컬렉션에 역할 공급자 인스턴스를 추가합니다.

providers 요소는 역할 관리에 대한 역할 공급자의 컬렉션을 정의합니다.

응용 프로그램 코드에서 roleManager 요소의 구성 값에 액세스하여 수정하는 방법에 대한 내용은 RoleManagerSection, WindowsTokenRoleProvider, SqlRoleProvider 및 AuthorizationStoreRoleProvider를 참조하십시오.

기본 구성

다음의 기본 providers 요소는 Machine.config 파일에 구성되어 있습니다.

<roleManager>
   <providers>
<add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
        <add name="AspNetWindowsTokenRoleProvider" applicationName="/" type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />   </providers>
</roleManager>

예제

다음 코드 예제에서는 SqlRoleProvider 클래스를 사용하여 역할 정보를 저장하고 검색하도록 ASP.NET 응용 프로그램을 구성하는 방법을 보여 줍니다.

<configuration>
  <system.web>
      <roleManager defaultProvider="SqlProvider" 
                   enabled="true"
                   cacheRolesInCookie="true"
                   cookieName=".ASPROLES"
                   cookieTimeout="30"
                   cookiePath="/"
                   cookieRequireSSL="false"
                   cookieSlidingExpiration="true"
                   cookieProtection="All" >
        <providers>
          <add
            name="SqlProvider"
            type="System.Web.Security.SqlRoleProvider"
            connectionStringName="SqlServices" 
            applicationName="SampleApplication" />
            
        </providers>
      </roleManager>
  </system.web>
</configuration>

요소 정보

구성 섹션 처리기	RoleManagerSection
구성 멤버	Add
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 2.0 Microsoft Visual Studio 2003 또는 Visual Studio 2005

참고 항목

다음을 통해 공유