RoleManagerSection 클래스

참조

정의

네임스페이스:: System.Web.Configuration

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

웹 애플리케이션의 역할 관리 인프라를 지원하는 데 사용되는 구성 설정을 정의합니다. 이 클래스는 상속될 수 없습니다.

public ref class RoleManagerSection sealed : System::Configuration::ConfigurationSection

public sealed class RoleManagerSection : System.Configuration.ConfigurationSection

type RoleManagerSection = class
    inherit ConfigurationSection

Public NotInheritable Class RoleManagerSection
Inherits ConfigurationSection

상속: Object

ConfigurationElement

ConfigurationSection
RoleManagerSection

예제

이 섹션에서는 두 코드 예제를 제공합니다. 첫 번째 값의 여러 속성을 선언적으로 지정 하는 방법에 설명 합니다 RoleManagerSection 클래스입니다. 두 번째를 사용 하는 방법에 설명 합니다 RoleManagerSection 형식입니다.

다음 구성 파일 예제에 선언적으로 일부의 속성에 대 한 값을 지정 하는 방법을 보여 줍니다는 RoleManagerSection 클래스입니다.

<system.web>  
  <roleManager   
    enabled="false"   
    cacheRolesInCookie="false"   
    cookieName=".ASPXROLES" cookieTimeout="30"  
    cookiePath="/" cookieRequireSSL="false"  
    cookieSlidingExpiration="true" createPersistentCookie="false"  
    cookieProtection="All"   
    defaultProvider="AspNetSqlRoleProvider"  
    maxCachedResults="25"  >  
    <providers>  
      <add   
        name="AspNetSqlRoleProvider"  
        connectionStringName="LocalSqlServer"   
        applicationName="/"  
        type="System.Web.Security.SqlRoleProvider, System.Web,  
          Version=2.0.3600.0, Culture=neutral,  
          PublicKeyToken=b03f5f7f11d50a3a" />  
      <add   
        name="AspNetWindowsTokenRoleProvider"   
        applicationName="/"  
        type="System.Web.Security.WindowsTokenRoleProvider, System.Web,   
          Version=2.0.3600.0, Culture=neutral,   
          PublicKeyToken=b03f5f7f11d50a3a" />  
    </providers>  
  </roleManager>  
</system.web>

다음 코드 예제를 사용 하는 방법에 설명 합니다 RoleManagerSection 형식입니다.

#region Using directives

using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Web;
using System.Web.Configuration;

#endregion

namespace Samples.Aspnet.SystemWebConfiguration
{
  class UsingRoleManagerSection
  {
    static void Main(string[] args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "";

        // Get the Web application configuration object.
        Configuration config = WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        RoleManagerSection configSection =
          (RoleManagerSection)config.GetSection("system.web/roleManager");

        // Display title and info.
        Console.WriteLine("ASP.NET Configuration Info");
        Console.WriteLine();

        // Display Config details.
        Console.WriteLine("File Path: {0}",
          config.FilePath);
        Console.WriteLine("Section Path: {0}",
          configSection.SectionInformation.Name);

        // Display CacheRolesInCookie property.
        Console.WriteLine("CacheRolesInCookie: {0}",
          configSection.CacheRolesInCookie);

        // Set CacheRolesInCookie property.
        configSection.CacheRolesInCookie = false;

        // Display CookieName property.
        Console.WriteLine("CookieName: {0}", configSection.CookieName);

        // Set CookieName property.
        configSection.CookieName = ".ASPXROLES";

        // Display CookiePath property.
        Console.WriteLine("CookiePath: {0}", configSection.CookiePath);

        // Set CookiePath property.
        configSection.CookiePath = "/";

        // Display CookieProtection property.
        Console.WriteLine("CookieProtection: {0}",
          configSection.CookieProtection);

        // Set CookieProtection property.
        configSection.CookieProtection =
          System.Web.Security.CookieProtection.All;

        // Display CookieRequireSSL property.
        Console.WriteLine("CookieRequireSSL: {0}",
          configSection.CookieRequireSSL);

        // Set CookieRequireSSL property.
        configSection.CookieRequireSSL = false;

        // Display CookieSlidingExpiration property.
        Console.WriteLine("CookieSlidingExpiration: {0}",
          configSection.CookieSlidingExpiration);

        // Set CookieSlidingExpiration property.
        configSection.CookieSlidingExpiration = true;

        // Display CookieTimeout property.
        Console.WriteLine("CookieTimeout: {0}", configSection.CookieTimeout);

        // Set CookieTimeout property.
        configSection.CookieTimeout = TimeSpan.FromMinutes(30);

        // Display CreatePersistentCookie property.
        Console.WriteLine("CreatePersistentCookie: {0}",
          configSection.CreatePersistentCookie);

        // Set CreatePersistentCookie property.
        configSection.CreatePersistentCookie = false;

        // Display DefaultProvider property.
        Console.WriteLine("DefaultProvider: {0}",
          configSection.DefaultProvider);

        // Set DefaultProvider property.
        configSection.DefaultProvider = "AspNetSqlRoleProvider";

        // Display Domain property.
        Console.WriteLine("Domain: {0}", configSection.Domain);

        // Set Domain property.
        configSection.Domain = "";

        // Display Enabled property.
        Console.WriteLine("Enabled: {0}", configSection.Enabled);

        // Set Enabled property.
        configSection.Enabled = false;

        // Display the number of Providers
        Console.WriteLine("Providers Collection Count: {0}",
          configSection.Providers.Count);

        // Display elements of the Providers collection property.
        foreach (ProviderSettings providerItem in configSection.Providers)
        {
          Console.WriteLine();
          Console.WriteLine("Provider Details:");
          Console.WriteLine("Name: {0}", providerItem.Name);
          Console.WriteLine("Type: {0}", providerItem.Type);
        }

        // Update if not locked.
        if (!configSection.SectionInformation.IsLocked)
        {
          config.Save();
          Console.WriteLine("** Configuration updated.");
        }
        else
        {
          Console.WriteLine("** Could not update, section is locked.");
        }
      }

      catch (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait
      Console.ReadLine();
    }
  }
}

Imports System.Collections.Generic
Imports System.Text
Imports System.Configuration
Imports System.Web
Imports System.Web.Configuration

Namespace Samples.Aspnet.SystemWebConfiguration
  Class UsingRoleManagerSection
    Public Shared Sub Main()
      Try
        ' Set the path of the config file.
        Dim configPath As String = ""

        ' Get the Web application configuration object.
        Dim config As System.Configuration.Configuration = _
         System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration(configPath)

        ' Get the section related object.
        Dim configSection As System.Web.Configuration.RoleManagerSection = _
         CType(config.GetSection("system.web/roleManager"), _
         System.Web.Configuration.RoleManagerSection)

        ' Display title and info.
        Console.WriteLine("ASP.NET Configuration Info")
        Console.WriteLine()

        ' Display Config details.
        Console.WriteLine("File Path: {0}", config.FilePath)
        Console.WriteLine("Section Path: {0}", configSection.SectionInformation.Name)

        ' Display CacheRolesInCookie property.
        Console.WriteLine("CacheRolesInCookie: {0}", _
         configSection.CacheRolesInCookie)

        ' Set CacheRolesInCookie property.
        configSection.CacheRolesInCookie = False

        ' Display CookieName property.
        Console.WriteLine("CookieName: {0}", configSection.CookieName)

        ' Set CookieName property.
        configSection.CookieName = ".ASPXROLES"

        ' Display CookiePath property.
        Console.WriteLine("CookiePath: {0}", configSection.CookiePath)

        ' Set CookiePath property.
        configSection.CookiePath = "/"

        ' Display CookieProtection property.
        Console.WriteLine("CookieProtection: {0}", _
         configSection.CookieProtection)

        ' Set CookieProtection property.
        configSection.CookieProtection = _
         System.Web.Security.CookieProtection.All

        ' Display CookieRequireSSL property.
        Console.WriteLine("CookieRequireSSL: {0}", _
         configSection.CookieRequireSSL)

        ' Set CookieRequireSSL property.
        configSection.CookieRequireSSL = False

        ' Display CookieSlidingExpiration property.
        Console.WriteLine("CookieSlidingExpiration: {0}", _
         configSection.CookieSlidingExpiration)

        ' Set CookieSlidingExpiration property.
        configSection.CookieSlidingExpiration = True

        ' Display CookieTimeout property.
        Console.WriteLine("CookieTimeout: {0}", configSection.CookieTimeout)

        ' Set CookieTimeout property.
        configSection.CookieTimeout = TimeSpan.FromMinutes(30)

        ' Display CreatePersistentCookie property.
        Console.WriteLine("CreatePersistentCookie: {0}", _
         configSection.CreatePersistentCookie)

        ' Set CreatePersistentCookie property.
        configSection.CreatePersistentCookie = False

        ' Display DefaultProvider property.
        Console.WriteLine("DefaultProvider: {0}", _
         configSection.DefaultProvider)

        ' Set DefaultProvider property.
        configSection.DefaultProvider = "AspNetSqlRoleProvider"

        ' Display Domain property.
        Console.WriteLine("Domain: {0}", configSection.Domain)

        ' Set Domain property.
        configSection.Domain = ""

        ' Display Enabled property.
        Console.WriteLine("Enabled: {0}", configSection.Enabled)

        ' Set CookieName property.
        configSection.Enabled = False

        ' Display the number of Providers
        Console.WriteLine("Providers Collection Count: {0}", _
         configSection.Providers.Count)

        ' Display elements of the Providers collection property.
        For Each providerItem As ProviderSettings In configSection.Providers()
          Console.WriteLine()
          Console.WriteLine("Provider Details:")
          Console.WriteLine("Name: {0}", providerItem.Name)
          Console.WriteLine("Type: {0}", providerItem.Type)
        Next

        ' Update if not locked.
        If Not configSection.SectionInformation.IsLocked Then
          config.Save()
          Console.WriteLine("** Configuration updated.")
        Else
          Console.WriteLine("** Could not update, section is locked.")
        End If

      Catch e As Exception
        ' Unknown error.
        Console.WriteLine(e.ToString())
      End Try

      ' Display and wait
      Console.ReadLine()
    End Sub
  End Class
End Namespace

설명

합니다 RoleManagerSection 클래스는 프로그래밍 방식으로 액세스 하 고 내용을 수정 하는 방법을 제공 합니다 roleManager 구성 파일의 섹션입니다.

생성자

RoleManagerSection()

기본 설정을 사용하여 RoleManagerSection 클래스의 새 인스턴스를 초기화합니다.

속성

CacheRolesInCookie	현재 사용자의 역할이 쿠키에 캐시되는지 여부를 나타내는 값을 가져오거나 설정합니다.
CookieName	역할 이름을 캐시하는 데 사용하는 쿠키의 이름을 가져오거나 설정합니다.
CookiePath	역할 이름을 캐시하는 데 사용하는 쿠키의 가상 경로를 가져오거나 설정합니다.
CookieProtection	역할 이름을 캐시하는 쿠키를 보호하는 데 사용하는 보안 형식을 가져오거나 설정합니다.
CookieRequireSSL	역할 이름을 캐시하는 데 사용하는 쿠키를 서버에 반환할 때 SSL(Secure Sockets Layer) 연결을 사용해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
CookieSlidingExpiration	역할 이름을 캐시하는 데 사용하는 쿠키를 정기적으로 다시 설정할지 여부를 나타내는 값을 가져오거나 설정합니다.
CookieTimeout	역할 이름을 캐시하는 데 사용하는 쿠키가 만료되기 전의 시간(분)을 가져오거나 설정합니다.
CreatePersistentCookie	역할 이름을 캐시하는 데 세션 기반 쿠키를 사용하는지 영구 쿠키를 사용하는지를 나타냅니다.
CurrentConfiguration	현재 Configuration 인스턴스가 속해 있는 구성 계층 구조를 나타내는 최상위 ConfigurationElement 인스턴스에 대한 참조를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
DefaultProvider	역할을 관리하는 데 사용하는 기본 공급자의 이름을 가져오거나 설정합니다.
Domain	역할 이름을 캐시하는 데 사용하는 쿠키와 관련된 도메인의 이름을 가져오거나 설정합니다.
ElementInformation	ElementInformation 개체의 사용자 지정할 수 없는 정보와 기능을 포함하는 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
ElementProperty	ConfigurationElementProperty 개체 자체를 나타내는 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
Enabled	ASP.NET 역할 관리 기능을 사용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
EvaluationContext	ContextInformation 개체의 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
HasContext	CurrentConfiguration 속성이 `null`인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
Item[ConfigurationProperty]	이 구성 요소의 속성이나 특성을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement)
Item[String]	이 구성 요소의 속성, 특성 또는 자식 요소를 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement)
LockAllAttributesExcept	잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockAllElementsExcept	잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockAttributes	잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockElements	잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockItem	요소가 잠겨 있는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement)
MaxCachedResults	ASP.NET에서 역할 쿠키에 캐시하는 최대 역할 수를 가져오거나 설정합니다.
Properties	속성 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
Providers	ProviderSettingsCollection 요소의 ProviderSettings 개체를 가져옵니다.
SectionInformation	사용자가 지정할 수 없는 SectionInformation 개체의 정보와 기능을 포함하는 ConfigurationSection 개체를 가져옵니다. (다음에서 상속됨 ConfigurationSection)

메서드

DeserializeElement(XmlReader, Boolean)	구성 파일에서 XML을 읽습니다. (다음에서 상속됨 ConfigurationElement)
DeserializeSection(XmlReader)	구성 파일에서 XML을 읽습니다. (다음에서 상속됨 ConfigurationSection)
Equals(Object)	현재 ConfigurationElement 인스턴스를 지정된 개체와 비교합니다. (다음에서 상속됨 ConfigurationElement)
GetHashCode()	현재 ConfigurationElement 인스턴스를 나타내는 고유 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
GetRuntimeObject()	파생 클래스에서 재정의될 때 사용자 지정 개체를 반환합니다. (다음에서 상속됨 ConfigurationSection)
GetTransformedAssemblyString(String)	지정된 어셈블리 이름의 변환된 버전을 반환합니다. (다음에서 상속됨 ConfigurationElement)
GetTransformedTypeString(String)	지정된 형식 이름의 변환된 버전을 반환합니다. (다음에서 상속됨 ConfigurationElement)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
Init()	ConfigurationElement 개체를 초기 상태로 설정합니다. (다음에서 상속됨 ConfigurationElement)
InitializeDefault()	ConfigurationElement 개체 값의 기본 집합을 초기화하는 데 사용됩니다. (다음에서 상속됨 ConfigurationElement)
IsModified()	이 구성 요소가 파생 클래스에서 구현되었을 때 마지막으로 저장되거나 로드된 이후 수정되었는지 여부를 나타냅니다. (다음에서 상속됨 ConfigurationSection)
IsReadOnly()	ConfigurationElement 개체가 읽기 전용인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
ListErrors(IList)	이 ConfigurationElement 개체와 모든 하위 요소의 잘못된 속성 오류를 전달된 목록에 추가합니다. (다음에서 상속됨 ConfigurationElement)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnDeserializeUnrecognizedAttribute(String, String)	역직렬화하는 동안 알 수 없는 특성을 발견했는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	역직렬화하는 동안 알 수 없는 요소를 발견했는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
OnRequiredPropertyNotFound(String)	필수 속성이 없으면 예외를 throw합니다. (다음에서 상속됨 ConfigurationElement)
PostDeserialize()	deserialization 후에 호출됩니다. (다음에서 상속됨 ConfigurationElement)
PreSerialize(XmlWriter)	serialization 전에 호출됩니다. (다음에서 상속됨 ConfigurationElement)
Reset(ConfigurationElement)	잠금 및 속성 컬렉션을 비롯하여 ConfigurationElement 개체의 내부 상태를 다시 설정합니다. (다음에서 상속됨 ConfigurationElement)
ResetModified()	파생 클래스에서 구현되는 경우 IsModified() 메서드의 값을 `false`로 다시 설정합니다. (다음에서 상속됨 ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	파생 클래스에서 구현될 때 구성 요소의 내용을 구성 파일에 씁니다. (다음에서 상속됨 ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	ConfigurationSection 개체의 병합되지 않은 뷰가 들어 있는 XML 문자열을 파일에 쓸 단일 섹션으로 만듭니다. (다음에서 상속됨 ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	파생 클래스에서 구현될 때 구성 요소의 외부 태그를 구성 파일에 씁니다. (다음에서 상속됨 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	속성을 지정된 값으로 설정합니다. (다음에서 상속됨 ConfigurationElement)
SetReadOnly()	IsReadOnly() 개체와 모든 하위 요소에 대한 ConfigurationElement 속성을 설정합니다. (다음에서 상속됨 ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	구성 개체 계층이 .NET Framework 지정된 대상 버전에 대해 직렬화될 때 지정된 요소를 serialize해야 하는지 여부를 나타냅니다. (다음에서 상속됨 ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	구성 개체 계층이 .NET Framework 지정된 대상 버전에 대해 serialize될 때 지정된 속성을 serialize해야 하는지 여부를 나타냅니다. (다음에서 상속됨 ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	구성 개체 계층 구조가 지정된 대상 버전의 .NET Framework 직렬화될 때 현재 ConfigurationSection 인스턴스를 serialize해야 하는지 여부를 나타냅니다. (다음에서 상속됨 ConfigurationSection)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	ConfigurationElement 개체를 수정하여 저장되지 않아야 하는 값을 모두 제거합니다. (다음에서 상속됨 ConfigurationElement)

적용 대상

다음을 통해 공유

RoleManagerSection 클래스

정의

예제

설명

생성자

속성

메서드

적용 대상

추가 정보

추가 리소스