WebConfigurationManager 클래스

정의

네임스페이스:

System.Web.Configuration

어셈블리:

System.Web.dll

구성 파일이 웹 애플리케이션에 적용될 때 해당 파일에 액세스할 수 있습니다.

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

상속

Object

WebConfigurationManager

예제

다음 예제에서는 사용 하 여 구성 정보에 액세스 하는 방법의

GetSection 메서드를 호출하여 생성됩니다.

// Show how to use the GetSection(string). 
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // Get the connectionStrings section.
    ConnectionStringsSection connectionStringsSection =
        WebConfigurationManager.GetSection("connectionStrings")
        as ConnectionStringsSection;

    // Get the connectionStrings key,value pairs collection.
    ConnectionStringSettingsCollection connectionStrings =
        connectionStringsSection.ConnectionStrings;
   
    // Get the collection enumerator.
    IEnumerator connectionStringsEnum =
        connectionStrings.GetEnumerator();

    // Loop through the collection and 
    // display the connectionStrings key, value pairs.
    int i = 0;
    Console.WriteLine("[Display the connectionStrings]");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

    Console.WriteLine();
}

' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("connectionStrings")
   
   ' Get the connectionStrings key,value pairs collection.
     Dim connectionStrings As ConnectionStringSettingsCollection = _
     connectionStringsSection.ConnectionStrings
   
   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator = _
     connectionStrings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display the connectionStrings]")
   While connectionStringsEnum.MoveNext()
      Dim name As String = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}", _
         name, connectionStrings(name))
      i += 1
   End While
   
   Console.WriteLine()
End Sub

설명

WebConfigurationManager 클래스 컴퓨터 및 애플리케이션 정보에 액세스할 수 있습니다.

사용 하 여 WebConfigurationManager 웹 애플리케이션과 관련 된 구성 파일을 사용 하 여 작업에 대 한 기본 방법입니다. 클라이언트 애플리케이션에 사용 된 ConfigurationManager 클래스입니다.

애플리케이션을 확장할 수 있습니다는 System.Configuration 또는 다음 목록에 설명 된 대로 구성 정보를 처리 하는 직접 사용 합니다.

• Handling configuration. 표준 형식을 사용 하 여 구성 정보를 처리 하려면 사용한 다음 방법 중 하나:

  • Accessing a section. 애플리케이션에 대 한 구성 정보에 액세스 하려면 해야 중 하나를 사용 합니다 GetSection 제공한 메서드 WebConfigurationManager합니다. 에 대 한 <appSettings> 및 <connectionStrings>를 사용 합니다 AppSettings 및 ConnectionStrings 속성입니다. 이러한 메서드 읽기 전용 작업을 수행할 구성의 캐시 된 단일 인스턴스를 사용 하 고 다중 스레드는 인식 합니다.

  • Accessing configuration files. 애플리케이션 읽고 로컬 또는 원격으로 모든 수준에서 또는 다른 애플리케이션이 나 컴퓨터 자체에 대 한 구성 설정을 쓸 수 있습니다. 중 하나를 사용 합니다 open 제공한 메서드 WebConfigurationManager합니다. 이러한 메서드는 반환 된 Configuration 에 필요한 메서드 및 기본 구성 파일을 처리 하는 속성을 제공 하는 개체입니다. 이러한 메서드 읽기 또는 쓰기 작업 및 수행 파일을 열 때마다 구성 데이터를 다시 만듭니다.

  • Advanced configuration. 고급 구성 처리 형식으로 제공 됩니다 SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation를 ContextInformation를 ConfigurationSectionGroup, 및 ConfigurationSectionGroupCollection합니다.

• Extending configuration standard types. 와 같은 표준 구성 형식을 확장 하 여 사용자 지정 구성 요소를 제공할 수도 있습니다 ConfigurationElement, ConfigurationElementCollection를 ConfigurationProperty, 및 ConfigurationSection 를 프로그래밍 방식으로 또는 특성이 지정 된 모델을 사용 하 여 합니다. 참조 된 ConfigurationSection 표준 구성 형식을 프로그래밍 방식으로 확장 하는 방법의 예는 클래스입니다. 참조 된 ConfigurationElement 특성 사용된 모델을 사용 하 여 표준 구성 형식을 확장 하는 방법의 예는 클래스입니다.

상속자 참고

Configuration 클래스는 구성 파일 편집에 대 한 프로그래밍 방식의 액세스를 허용 합니다. 제공한 오픈 메서드 중 하나를 사용 하면 WebConfigurationManager합니다. 이러한 메서드는 반환 된 Configuration 에 필요한 메서드 및 기본 구성 파일을 처리 하는 속성을 제공 하는 개체입니다. 이러한 파일을 읽기용 또는 쓰기용 다음과 같이 액세스할 수 있습니다.

사용할 GetSection(String) 또는 GetSectionGroup(String) 구성 정보를 읽습니다. Note 사용자나 읽는 프로세스는 다음 권한이 있어야 합니다.

• 현재 구성 계층 수준에서 구성 파일에 대한 읽기 권한입니다.

• 모든 부모 구성 파일에 대한 읽기 권한입니다.

애플리케이션에서 자체 구성에 대 한 읽기 전용 액세스에 필요한 것이 좋습니다 사용할를 GetSection 메서드. 이러한 메서드에 액세스할 수 있는 보다 더 나은 성능을 현재 애플리케이션에 대 한 캐시 된 구성 값에는 Configuration 클래스입니다.

참고: 매개 변수를 사용하는 path 정적 GetSection 메서드를 사용하는 경우 path 매개 변수는 코드가 실행 중인 애플리케이션을 참조해야 합니다. 그렇지 않으면 매개 변수가 무시되고 현재 실행 중인 애플리케이션에 대한 구성 정보가 반환됩니다.

하나를 사용 하 여 Save 구성 정보를 기록 하는 방법. Note는 사용자 또는 기록 하는 프로세스는 다음 권한이 있어야 합니다.

• 현재 구성 계층 수준에서 구성 파일 및 디렉터리에 대한 쓰기 권한입니다.

• 모든 구성 파일에 대한 읽기 권한입니다.

속성

AppSettings	웹 사이트의 애플리케이션 설정을 가져옵니다.
ConnectionStrings	웹 사이트의 연결 문자열을 가져옵니다.

메서드

GetSection(String)	현재 웹 애플리케이션의 구성 파일에서 지정된 구성 섹션을 검색합니다.
GetSection(String, String)	지정한 위치의 웹 애플리케이션 구성 파일에서 지정된 구성 섹션을 검색합니다.
GetWebApplicationSection(String)	현재 웹 애플리케이션의 구성 파일에서 지정된 구성 섹션을 검색합니다.
OpenMachineConfiguration()	현재 컴퓨터의 컴퓨터 구성 파일을 Configuration 개체로 열어 읽기 또는 쓰기 작업을 허용합니다.
OpenMachineConfiguration(String)	현재 컴퓨터의 컴퓨터 구성 파일을 Configuration 개체로 열어 읽기 또는 쓰기 작업을 허용합니다.
OpenMachineConfiguration(String, String)	지정된 서버의 지정된 컴퓨터 구성 파일을 Configuration 개체로 열어 읽기 또는 쓰기 작업을 허용합니다.
OpenMachineConfiguration(String, String, IntPtr)	지정된 서버의 지정된 컴퓨터 구성 파일을 Configuration 개체로 열어 지정된 보안 컨텍스트를 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenMachineConfiguration(String, String, String, String)	지정된 서버의 지정된 컴퓨터 구성 파일을 Configuration 개체로 열어 지정된 보안 컨텍스트를 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenMappedMachineConfiguration(ConfigurationFileMap)	컴퓨터 구성 파일을 Configuration 개체로 열어 지정된 파일 매핑을 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	컴퓨터 구성 파일을 Configuration 개체로 열어 지정된 파일 매핑 및 위치를 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	웹 응용 프로그램 구성 파일을 Configuration 개체로 열어 지정된 파일 매핑 및 가상 경로를 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	지정된 웹 애플리케이션 구성 파일을 Configuration 개체로 열어 지정된 파일 매핑, 가상 경로 및 사이트 이름을 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	지정된 웹 응용 프로그램 구성 파일을 Configuration 개체로 열어 지정된 파일 매핑, 가상 경로, 사이트 이름 및 위치를 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenWebConfiguration(String)	웹 응용 프로그램 구성 파일을 Configuration 개체로 열어 지정된 가상 경로를 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenWebConfiguration(String, String)	웹 응용 프로그램 구성 파일을 Configuration 개체로 열어 지정된 가상 경로 및 사이트 이름을 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenWebConfiguration(String, String, String)	웹 응용 프로그램 구성 파일을 Configuration 개체로 열어 지정된 가상 경로, 사이트 이름 및 위치를 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenWebConfiguration(String, String, String, String)	웹 응용 프로그램 구성 파일을 Configuration 개체로 열어 지정된 가상 경로, 사이트 이름, 위치 및 서버를 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenWebConfiguration(String, String, String, String, IntPtr)	웹 응용 프로그램 구성 파일을 Configuration 개체로 열어 지정된 가상 경로, 사이트 이름, 위치, 서버 및 보안 컨텍스트를 사용하여 읽기 또는 쓰기 작업을 허용합니다.
OpenWebConfiguration(String, String, String, String, String, String)	웹 응용 프로그램 구성 파일을 Configuration 개체로 열어 지정된 가상 경로, 사이트 이름, 위치, 서버 및 보안 컨텍스트를 사용하여 읽기 또는 쓰기 작업을 허용합니다.

추가 정보

• Configuration
• ConfigurationManager
• ASP.NET 구성 개요