ConfigurationBuilder 클래스

정의

네임스페이스:

Microsoft.Extensions.Configuration

어셈블리:

Microsoft.Extensions.Configuration.dll

패키지:

Microsoft.Extensions.Configuration v8.0.0

Source:

ConfigurationBuilder.cs

애플리케이션에서 사용할 키/값 기반 구성 설정을 빌드하는 데 사용됩니다.

public ref class ConfigurationBuilder : Microsoft::Extensions::Configuration::IConfigurationBuilder

public class ConfigurationBuilder : Microsoft.Extensions.Configuration.IConfigurationBuilder

type ConfigurationBuilder = class
    interface IConfigurationBuilder

Public Class ConfigurationBuilder
Implements IConfigurationBuilder

상속

Object

ConfigurationBuilder

구현

IConfigurationBuilder

설명

이 클래스를 사용하면 예를 들어 JSON 파일에 구성 값을 저장한 다음 런타임에 검색할 수 있습니다. 자세한 내용은 구성 - 기본 예제를 참조하세요.

앱을 .NET Core 3.1 이상 버전으로 마이그레이션하는 경우 이 클래스를 사용하여 이전에 앱을 구성하는 데 사용했을 수 있는 app.config 파일 기능을 바꿀 수 있습니다.

예제

다음 코드 조각은 런타임에 JSON 파일에서 문자열 값을 검색하는 개체를 만드는 ConfigurationBuilder 간소화된 앱을 보여줍니다.

using Microsoft.Extensions.Configuration;

IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json", false, true);
IConfigurationRoot root = builder.Build();

Console.WriteLine($"Hello, { root["weather"] } world!");

/* This program outputs the following text:
 * 
 * Hello, stormy world!
 */

JSON 파일의 내용은 여기에 표시됩니다.

{
  "weather": "stormy"
}

생성자

ConfigurationBuilder()

ConfigurationBuilder 클래스의 새 인스턴스를 초기화합니다.

속성

Properties	및 등록된 구성 공급자 간에 IConfigurationBuilder 데이터를 공유하는 데 사용할 수 있는 키/값 컬렉션을 가져옵니다.
Sources	구성 값을 가져오는 데 사용되는 소스를 가져옵니다.

메서드

Add(IConfigurationSource)	새 구성 소스를 추가합니다.
Build()	Sources에 등록된 공급자 집합의 키와 값을 사용하여 IConfiguration을 빌드합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

확장 메서드

AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	애플리케이션 메타데이터에 대한 구성 공급자를 등록합니다.
AddConfiguration(IConfigurationBuilder, IConfiguration)	configurationBuilder에 기존 구성을 추가합니다.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	configurationBuilder에 기존 구성을 추가합니다.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	명령줄에서 구성 값을 읽는 IConfigurationProvider를 추가합니다.
AddCommandLine(IConfigurationBuilder, String[])	명령줄에서 구성 값을 읽는 CommandLineConfigurationProvider를 추가합니다.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	지정된 스위치 매핑을 사용하여 명령줄에서 구성 값을 읽는 CommandLineConfigurationProvider를 추가합니다.
Add<TSource>(IConfigurationBuilder, Action<TSource>)	새 구성 소스를 추가합니다.
AddEnvironmentVariables(IConfigurationBuilder)	환경 변수에서 구성 값을 읽는 IConfigurationProvider를 추가합니다.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	환경 변수에서 구성 값을 읽는 IConfigurationProvider를 추가합니다.
AddEnvironmentVariables(IConfigurationBuilder, String)	지정된 접두사를 가진 환경 변수에서 구성 값을 읽는 IConfigurationProvider를 추가합니다.
GetFileLoadExceptionHandler(IConfigurationBuilder)	파일 기반 공급자에 사용할 기본 IFileProvider를 가져옵니다.
GetFileProvider(IConfigurationBuilder)	파일 기반 공급자에 사용할 기본 IFileProvider를 가져옵니다.
SetBasePath(IConfigurationBuilder, String)	기본 경로를 사용하여 파일 기반 공급자의 FileProvider를 PhysicalFileProvider로 설정합니다.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	오류가 발생할 때 파일 기반 공급자에 대해 호출할 기본 동작을 설정합니다.
SetFileProvider(IConfigurationBuilder, IFileProvider)	파일 기반 공급자에 사용할 기본 IFileProvider를 설정합니다.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	builder에 INI 구성 소스를 추가합니다.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	builder에 INI 구성 소스를 추가합니다.
AddIniFile(IConfigurationBuilder, String)	path에 있는 INI 구성 공급자를 builder에 추가합니다.
AddIniFile(IConfigurationBuilder, String, Boolean)	path에 있는 INI 구성 공급자를 builder에 추가합니다.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	path에 있는 INI 구성 공급자를 builder에 추가합니다.
AddIniStream(IConfigurationBuilder, Stream)	builder에 INI 구성 소스를 추가합니다.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	builder에 JSON 구성 소스를 추가합니다.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	builder에 JSON 구성 소스를 추가합니다.
AddJsonFile(IConfigurationBuilder, String)	path에 있는 JSON 구성 공급자를 builder에 추가합니다.
AddJsonFile(IConfigurationBuilder, String, Boolean)	path에 있는 JSON 구성 공급자를 builder에 추가합니다.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	path에 있는 JSON 구성 공급자를 builder에 추가합니다.
AddJsonStream(IConfigurationBuilder, Stream)	builder에 JSON 구성 소스를 추가합니다.
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	디렉터리의 파일을 사용하여 구성을 추가합니다. 파일 이름은 키로 사용되고 파일 콘텐츠는 값으로 사용됩니다.
AddKeyPerFile(IConfigurationBuilder, String)	디렉터리의 파일을 사용하여 구성을 추가합니다. 파일 이름은 키로 사용되고 파일 콘텐츠는 값으로 사용됩니다.
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	디렉터리의 파일을 사용하여 구성을 추가합니다. 파일 이름은 키로 사용되고 파일 콘텐츠는 값으로 사용됩니다.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)	디렉터리의 파일을 사용하여 구성을 추가합니다. 파일 이름은 키로 사용되고 파일 콘텐츠는 값으로 사용됩니다.
AddInMemoryCollection(IConfigurationBuilder)	configurationBuilder에 메모리 구성 공급자를 추가합니다.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	configurationBuilder에 메모리 구성 공급자를 추가합니다.
AddUserSecrets(IConfigurationBuilder, Assembly)	사용자 비밀 구성 소스를 추가합니다. assembly에서 사용자 비밀 ID를 지정하는 UserSecretsIdAttribute 인스턴스를 검색합니다. 사용자 비밀 ID는 암호 구성 값 컬렉션을 저장하고 식별하는 데 사용되는 고유한 값입니다.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	사용자 비밀 구성 소스를 추가합니다. assembly에서 사용자 비밀 ID를 지정하는 UserSecretsIdAttribute 인스턴스를 검색합니다. 사용자 비밀 ID는 암호 구성 값 컬렉션을 저장하고 식별하는 데 사용되는 고유한 값입니다.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	사용자 비밀 구성 소스를 추가합니다. assembly에서 사용자 비밀 ID를 지정하는 UserSecretsIdAttribute 인스턴스를 검색합니다. 사용자 비밀 ID는 암호 구성 값 컬렉션을 저장하고 식별하는 데 사용되는 고유한 값입니다.
AddUserSecrets(IConfigurationBuilder, String)	지정된 사용자 비밀 ID를 사용하여 사용자 비밀 구성 소스를 추가합니다. 사용자 비밀 ID는 암호 구성 값 컬렉션을 저장하고 식별하는 데 사용되는 고유한 값입니다.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	지정된 사용자 비밀 ID를 사용하여 사용자 비밀 구성 소스를 추가합니다. 사용자 비밀 ID는 암호 구성 값 컬렉션을 저장하고 식별하는 데 사용되는 고유한 값입니다.
AddUserSecrets<T>(IConfigurationBuilder)	사용자 비밀 구성 소스를 추가합니다. T 형식을 포함하는 어셈블리에서 사용자 비밀 ID를 지정하는 UserSecretsIdAttribute 인스턴스를 검색합니다. 사용자 비밀 ID는 암호 구성 값 컬렉션을 저장하고 식별하는 데 사용되는 고유한 값입니다.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	사용자 비밀 구성 소스를 추가합니다. T 형식을 포함하는 어셈블리에서 사용자 비밀 ID를 지정하는 UserSecretsIdAttribute 인스턴스를 검색합니다. 사용자 비밀 ID는 암호 구성 값 컬렉션을 저장하고 식별하는 데 사용되는 고유한 값입니다.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	사용자 비밀 구성 소스를 추가합니다. T 형식을 포함하는 어셈블리에서 사용자 비밀 ID를 지정하는 UserSecretsIdAttribute 인스턴스를 검색합니다. 사용자 비밀 ID는 암호 구성 값 컬렉션을 저장하고 식별하는 데 사용되는 고유한 값입니다.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	builder에 XML 구성 소스를 추가합니다.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	builder에 XML 구성 소스를 추가합니다.
AddXmlFile(IConfigurationBuilder, String)	path에 있는 XML 구성 공급자를 builder에 추가합니다.
AddXmlFile(IConfigurationBuilder, String, Boolean)	path에 있는 XML 구성 공급자를 builder에 추가합니다.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	path에 있는 XML 구성 공급자를 builder에 추가합니다.
AddXmlStream(IConfigurationBuilder, Stream)	builder에 XML 구성 소스를 추가합니다.

추가 정보

• .NET의 구성