WebConfigurationManager.GetSection 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
현재 애플리케이션의 기본 구성 파일에서 지정된 구성 섹션을 검색합니다.
오버로드
| GetSection(String) |
현재 애플리케이션의 구성 파일에서 지정된 구성 섹션을 검색합니다. |
| GetSection(HttpContext, String) |
지정된 컨텍스트와 관련하여 애플리케이션의 구성 파일에서 지정된 구성 섹션을 검색합니다. |
| GetSection(String, String, String) |
웹 사이트 이름, 가상 경로 및 섹션 경로를 사용하여 지정된 구성 섹션을 검색합니다. |
| GetSection(HttpContext, String, Type) |
지정된 컨텍스트와 관련하여 애플리케이션의 구성 파일에서 지정된 구성 섹션 형식을 사용하여 지정된 구성 섹션을 검색합니다. |
| GetSection(String, String, String, Type) |
웹 사이트 이름, 가상 경로, 섹션 경로 및 런타임 형식을 사용하여 지정된 구성 섹션을 검색합니다. |
GetSection(String)
현재 애플리케이션의 구성 파일에서 지정된 구성 섹션을 검색합니다.
public:
static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::String ^ sectionPath);public static Microsoft.Web.Administration.ConfigurationSection GetSection (string sectionPath);static member GetSection : string -> Microsoft.Web.Administration.ConfigurationSectionPublic Shared Function GetSection (sectionPath As String) As ConfigurationSection매개 변수
- sectionPath
- String
구성 섹션 이름입니다.
반환
지정된 구성 섹션 개체이거나, 섹션이 없는 경우 null입니다.
예외
유효한 구성 파일을 로드할 수 없습니다.
설명
GetSection(String) 웹 애플리케이션 내에서 오버로드가 호출되면 웹 애플리케이션의 구성 계층 구조에 따라 시스템에서 선택한 구성 파일의 섹션을 반환합니다.
주의
애플리케이션이 HTTP 이외의 프로토콜을 사용하는 경우 또는 GetSection(String, String, String, Type) 오버로드를 사용해야 GetSection(HttpContext, String) 합니다. 이 오버로드는 각각 매개 변수 목록에서 섹션 이름과 개체를 System.Web.HttpContext 모두 사용합니다. 시스템이 특정 구성 계층 구조 수준에서 구성 설정을 반환할 수 있도록 하려면 를 지정 HttpContext 해야 합니다. 그러나 지정된 구성 경로가 현재 애플리케이션 외부에 있는 GetSection(String, String, String, Type) 경우 현재 실행 중인 애플리케이션 GetSection 에 대한 애플리케이션 수준 구성 설정을 반환합니다. 섹션 이름만 사용하는 를 사용하는 GetSection(String)경우 시스템은 항상 애플리케이션 수준에서 구성 설정을 반환하려고 시도합니다.
중요
를 런타임 작업으로 사용하는 GetSection(String) 것은 보안 제한에 의해 제한됩니다. 예를 들어 런타임에 섹션에 액세스하거나 수정하지 못할 수 있습니다.
적용 대상
GetSection(HttpContext, String)
지정된 컨텍스트와 관련하여 애플리케이션의 구성 파일에서 지정된 구성 섹션을 검색합니다.
public:
static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::Web::HttpContext ^ context, System::String ^ sectionPath);public static Microsoft.Web.Administration.ConfigurationSection GetSection (System.Web.HttpContext context, string sectionPath);static member GetSection : System.Web.HttpContext * string -> Microsoft.Web.Administration.ConfigurationSectionPublic Shared Function GetSection (context As HttpContext, sectionPath As String) As ConfigurationSection매개 변수
- context
- HttpContext
현재 요청의 HttpContext입니다.
- sectionPath
- String
구성 섹션 이름입니다.
반환
지정된 구성 섹션 개체이거나, 섹션이 없는 경우 null입니다.
예외
유효한 구성 파일을 로드할 수 없습니다.
설명
GetSection(HttpContext, String) 웹 애플리케이션 내에서 오버로드가 호출되면 웹 애플리케이션의 개체에 따라 시스템에서 선택한 구성 파일의 섹션을 System.Web.HttpContext 반환합니다.
주의
애플리케이션에서 HTTP 이외의 프로토콜을 사용하는 경우 또는 GetSection(String, String, String, Type) 오버로드를 사용해야 GetSection(HttpContext, String) 합니다. 이 오버로드는 각각 섹션 이름과 HttpContext 매개 변수 목록에서 를 모두 사용합니다. 시스템이 특정 구성 계층 구조 수준에서 구성 설정을 반환할 수 있도록 하려면 를 지정 HttpContext 해야 합니다. 그러나 지정된 구성 경로가 현재 애플리케이션 외부에 있는 GetSection(String, String, String, Type) 경우 현재 실행 중인 애플리케이션 GetSection(HttpContext, String) 에 대한 애플리케이션 수준 구성 설정을 반환합니다. 섹션 이름만 사용하는 오버로드를 사용하는 GetSection(String) 경우 시스템은 항상 애플리케이션 수준에서 구성 설정을 반환하려고 시도합니다.
중요
를 런타임 작업으로 사용하는 GetSection(HttpContext, String) 것은 보안 제한에 의해 제한됩니다. 예를 들어 런타임에 섹션에 액세스하거나 수정하지 못할 수 있습니다.
적용 대상
GetSection(String, String, String)
웹 사이트 이름, 가상 경로 및 섹션 경로를 사용하여 지정된 구성 섹션을 검색합니다.
public:
static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::String ^ siteName, System::String ^ virtualPath, System::String ^ sectionPath);public static Microsoft.Web.Administration.ConfigurationSection GetSection (string siteName, string virtualPath, string sectionPath);static member GetSection : string * string * string -> Microsoft.Web.Administration.ConfigurationSectionPublic Shared Function GetSection (siteName As String, virtualPath As String, sectionPath As String) As ConfigurationSection매개 변수
- siteName
- String
웹 사이트 이름입니다.
- virtualPath
- String
Web.config 파일의 가상 경로입니다.
- sectionPath
- String
구성 섹션 이름입니다.
반환
ConfigurationSection 개체입니다.
예외
유효한 구성 파일을 로드할 수 없습니다.
메서드에 전달되는 매개 변수 중 하나는 입니다 null.
설명
GetSection(String, String, String) 오버로드는 요청된 ConfigurationSection 위치에 대한 구성을 나타내는 개체를 반환합니다. 이 메서드는 먼저 매개 변수에서 siteName 요청된 웹 사이트를 찾은 다음 지정된 virtualPath에서 Web.config 파일을 찾습니다. GetSection(String, String, String) 그런 다음 Web.config 파일에서 요청된 구성 sectionPath을 검색합니다.
중요 를 런타임 작업으로 사용하는 GetSection(String, String, String) 것은 보안 제한에 의해 제한됩니다. 예를 들어 런타임에 섹션에 액세스하거나 수정하지 못할 수 있습니다.
적용 대상
GetSection(HttpContext, String, Type)
지정된 컨텍스트와 관련하여 애플리케이션의 구성 파일에서 지정된 구성 섹션 형식을 사용하여 지정된 구성 섹션을 검색합니다.
public:
static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::Web::HttpContext ^ context, System::String ^ sectionPath, Type ^ sectionType);public static Microsoft.Web.Administration.ConfigurationSection GetSection (System.Web.HttpContext context, string sectionPath, Type sectionType);static member GetSection : System.Web.HttpContext * string * Type -> Microsoft.Web.Administration.ConfigurationSectionPublic Shared Function GetSection (context As HttpContext, sectionPath As String, sectionType As Type) As ConfigurationSection매개 변수
- context
- HttpContext
HttpContext 현재 요청의 개체입니다.
- sectionPath
- String
구성 섹션 이름입니다.
- sectionType
- Type
구성 섹션 유형
반환
지정된 구성 섹션 개체이거나, 섹션이 없는 경우 null입니다.
예외
유효한 구성 파일을 로드할 수 없습니다.
메서드에 전달되는 매개 변수 중 하나는 입니다 null.
매개 변수의 sectionType 값은 클래스에서 ConfigurationSection 파생되지 않거나 공용 생성자를 제공하지 않습니다.
설명
오버로드가 GetSection(HttpContext, String, Type) 웹 애플리케이션 내에서 호출되는 경우 제공된 및 sectionType 매개 변수뿐만 아니라 웹 애플리케이션의 개체에 따라 System.Web.HttpContext 시스템에서 선택한 구성 파일의 섹션을 sectionPath 반환합니다.
주의
애플리케이션에서 HTTP 이외의 프로토콜을 사용하는 경우 또는 GetSection(String, String, String, Type) 오버로드를 사용해야 GetSection(HttpContext, String) 합니다. 이 오버로드는 각각 섹션 이름과 HttpContext 매개 변수 목록에서 를 모두 사용합니다. 시스템이 특정 구성 계층 구조 수준에서 구성 설정을 반환할 수 있도록 하려면 를 지정 HttpContext 해야 합니다. 그러나 지정된 구성 경로가 현재 애플리케이션 외부에 있는 GetSection(String, String, String, Type) 경우 현재 실행 중인 애플리케이션 GetSection(HttpContext, String) 에 대한 애플리케이션 수준 구성 설정을 반환합니다. 섹션 이름만 사용하는 오버로드를 사용하는 GetSection(String) 경우 시스템은 항상 애플리케이션 수준에서 구성 설정을 반환하려고 시도합니다.
중요
를 런타임 작업으로 사용하는 GetSection(HttpContext, String, Type) 것은 보안 제한에 의해 제한됩니다. 예를 들어 런타임에 섹션에 액세스하거나 수정하지 못할 수 있습니다.
적용 대상
GetSection(String, String, String, Type)
웹 사이트 이름, 가상 경로, 섹션 경로 및 런타임 형식을 사용하여 지정된 구성 섹션을 검색합니다.
public:
static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::String ^ siteName, System::String ^ virtualPath, System::String ^ sectionPath, Type ^ sectionType);public static Microsoft.Web.Administration.ConfigurationSection GetSection (string siteName, string virtualPath, string sectionPath, Type sectionType);static member GetSection : string * string * string * Type -> Microsoft.Web.Administration.ConfigurationSectionPublic Shared Function GetSection (siteName As String, virtualPath As String, sectionPath As String, sectionType As Type) As ConfigurationSection매개 변수
- siteName
- String
웹 사이트 이름입니다.
- virtualPath
- String
Web.config 파일의 가상 경로입니다.
- sectionPath
- String
구성 섹션 이름입니다.
- sectionType
- Type
구성 섹션의 런타임 형식입니다.
반환
ConfigurationSection 개체입니다.
설명
GetSection(String, String, String, Type) 오버로드는 요청된 ConfigurationSection 위치에 대한 구성을 나타내는 개체를 반환합니다. 이 메서드는 먼저 매개 변수에서 siteName 요청된 웹 사이트를 찾은 다음 지정된 virtualPath에서 Web.config 파일을 찾습니다. GetSection(String, String, String, Type) 그런 다음 Web.config 파일에서 매개 변수에 제공된 런타임 형식과 일치하는 요청된 구성 sectionPath 을 sectionType 검색합니다.
중요
를 런타임 작업으로 사용하는 GetSection(String, String, String, Type) 것은 보안 제한에 의해 제한됩니다. 예를 들어 런타임에 섹션에 액세스하거나 수정하지 못할 수 있습니다.