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, , PropertyInformationPropertyInformationCollection, ElementInformationContextInformationConfigurationSectionGroup및 .ConfigurationSectionGroupCollection

• Extending configuration standard types; , 등의 ConfigurationElementConfigurationElementCollectionConfigurationPropertyConfigurationSection 표준 구성 유형을 확장하고 프로그래밍 방식 또는 특성 모델을 사용하여 사용자 지정 구성 요소를 제공할 수도 있습니다. ConfigurationSection 프로그래밍 방식으로 표준 구성 형식을 확장하는 방법에 대한 예제는 클래스를 참조하세요. 특성 모델을 ConfigurationElement 사용하여 표준 구성 형식을 확장하는 방법에 대한 예제는 클래스를 참조하세요.

상속자 참고

이 Configuration 클래스는 구성 파일을 편집하기 위한 프로그래밍 방식 액세스를 허용합니다. 에서 제공하는 WebConfigurationManager열린 메서드 중 하나를 사용합니다. 이러한 메서드는 개체를 Configuration 반환하며, 이 개체는 기본 구성 파일을 처리하는 데 필요한 메서드와 속성을 제공합니다. 다음과 같이 읽기 또는 쓰기를 위해 이러한 파일에 액세스할 수 있습니다.

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

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

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

애플리케이션이 자체 구성에 대한 읽기 전용 액세스 권한이 필요한 경우 메서드를 GetSection 사용하는 것이 좋습니다. 이러한 메서드는 현재 애플리케이션에 대해 캐시된 구성 값에 대한 액세스를 제공하며, 클래스보다 성능이 Configuration 향상됩니다.

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

메서드 중 Save 하나를 사용하여 구성 정보를 작성합니다. 작성하는 사용자 또는 프로세스에는 다음 권한이 있어야 합니다.

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

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

속성

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

메서드

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

추가 정보

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