내보내기(0) 인쇄
모두 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

WebConfigurationManager 클래스

구성 파일이 웹 응용 프로그램에 적용될 때 해당 파일에 액세스할 수 있습니다.

System.Object
  System.Web.Configuration.WebConfigurationManager

네임스페이스:  System.Web.Configuration
어셈블리:  System.Web(System.Web.dll)

public static class WebConfigurationManager

WebConfigurationManager 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 속성정적 멤버AppSettings웹 사이트의 응용 프로그램 설정을 가져옵니다.
Public 속성정적 멤버ConnectionStrings웹 사이트의 연결 문자열을 가져옵니다.
위쪽

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

WebConfigurationManager 클래스를 사용하면 컴퓨터와 응용 프로그램 정보에 액세스할 수 있습니다.

웹 응용 프로그램과 관련된 구성 파일 작업에는 WebConfigurationManager를 사용하는 것이 좋습니다. 클라이언트 응용 프로그램의 경우 ConfigurationManager 클래스를 사용합니다.

응용 프로그램에서는 System.Configuration 형식을 확장하거나 이 형식을 직접 사용하여 다음 목록에서 설명한 것처럼 구성 정보를 처리할 수 있습니다.

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

    • Accessing a section . 응용 프로그램의 구성 정보에 액세스하려면 WebConfigurationManager에서 제공하는 GetSection 메서드 중 하나를 사용해야 합니다. <appSettings> <connectionStrings>의 경우 AppSettingsConnectionStrings 속성을 사용합니다. 이러한 메서드는 읽기 전용 작업을 수행하고 구성의 캐시된 단일 인스턴스를 사용하며 다중 스레드를 인식합니다.

    • Accessing configuration files . 응용 프로그램에서 해당 응용 프로그램이나 다른 응용 프로그램 또는 다른 컴퓨터에 대한 모든 수준의 구성 설정을 로컬 또는 원격으로 읽고 쓸 수 있습니다. WebConfigurationManager 에서 제공하는 open 메서드 중 하나를 사용할 수 있습니다. 이러한 메서드는 Configuration 개체를 반환하며, 이 개체는 내부 구성 파일을 처리하는 데 필요한 메서드와 속성을 제공합니다. 또한 이러한 메서드는 읽기 또는 쓰기 작업을 수행하고 파일이 열릴 때마다 구성 데이터를 다시 만듭니다.

    • Advanced configuration . 고급 구성 처리 기능은 SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, ConfigurationSectionGroupConfigurationSectionGroupCollection 형식에서 제공합니다.

  • Extending configuration standard types . 프로그래밍 또는 특성을 사용하는 모델로 ConfigurationElement, ConfigurationElementCollection, ConfigurationPropertyConfigurationSection과 같은 표준 구성 형식을 확장하여 사용자 지정 구성 요소를 제공할 수도 있습니다. 프로그래밍 방식으로 표준 구성 형식을 확장하는 방법에 대한 예제를 보려면 ConfigurationSection 클래스를 참조하고, 특성 사용 모델을 사용하여 표준 구성 형식을 확장하는 방법에 대한 예제를 보려면 ConfigurationElement 클래스를 참조하십시오.

구현자 참고 사항

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

GetSection 또는 GetSectionGroup을 사용하여 구성 정보를 읽습니다. 읽는 사용자나 프로세스에 다음과 같은 권한이 있어야 합니다.

  • 현재 구성 계층 구조 수준의 구성 파일에 대한 읽기 권한

  • 모든 부모 구성 파일에 대한 읽기 권한

응용 프로그램에 자체 구성에 대한 읽기 전용 권한이 필요하면 GetSection 메서드를 사용하는 것이 좋습니다. 이러한 메서드는 Configuration 클래스보다 성능이 좋은 현재 응용 프로그램의 캐시된 구성 값에 액세스할 수 있도록 합니다.

참고참고

path 매개 변수를 사용하는 정적 GetSection 메서드를 사용하는 경우 path 매개 변수는 코드가 실행되고 있는 응용 프로그램을 참조해야 합니다. 그렇지 않으면 매개 변수가 무시되고 현재 실행되는 응용 프로그램의 구성 정보가 반환됩니다.

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

  • 현재 구성 계층 구조 수준의 구성 파일과 디렉터리에 대한 쓰기 권한

  • 모든 구성 파일에 대한 읽기 권한

TopicLocation
방법: 프로그래밍 방식으로 ASP.NET 구성 설정 사용Configuring ASP .NET Web Applications
방법: ASP.NET 구성 설정 잠금Configuring ASP .NET Web Applications
방법: 상속된 구성 설정과 로컬 구성 설정을 프로그래밍 방식으로 보기Configuring ASP .NET Web Applications
방법: 프로그래밍 방식으로 ASP.NET 구성 설정 사용Visual Studio에서 ASP .NET 웹 응용 프로그램 빌드
방법: ASP.NET 구성 설정 잠금Visual Studio에서 ASP .NET 웹 응용 프로그램 빌드
방법: 상속된 구성 설정과 로컬 구성 설정을 프로그래밍 방식으로 보기Visual Studio에서 ASP .NET 웹 응용 프로그램 빌드
방법: 프로그래밍 방식으로 ASP.NET 구성 설정 사용Visual Studio에서 ASP .NET 웹 응용 프로그램 빌드
방법: ASP.NET 구성 설정 잠금Visual Studio에서 ASP .NET 웹 응용 프로그램 빌드
방법: 상속된 구성 설정과 로컬 구성 설정을 프로그래밍 방식으로 보기Visual Studio에서 ASP .NET 웹 응용 프로그램 빌드

다음 예제에서는 메서드를 사용하여 구성 정보에 액세스하는 방법을 보여 줍니다.

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();
        }



.NET Framework

4.5, 4, 3.5, 3.0, 2.0에서 지원

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework 에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 다음을 참조하십시오. .NET Framework 시스템 요구 사항.

이 형식의 static(Visual Basic의 경우 Shared) 모든 공용 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

커뮤니티 추가 항목

추가
Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2015 Microsoft