ConfigurationBuilder 클래스

정의

네임스페이스:

Microsoft.Extensions.Configuration

어셈블리:

Microsoft.Extensions.Configuration.dll

패키지:

Microsoft.Extensions.Configuration v9.0.0-preview.7.24405.7

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)	builderINI 구성 원본을 추가합니다.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	builderINI 구성 원본을 추가합니다.
AddIniFile(IConfigurationBuilder, String)	path INI 구성 공급자를 builder추가합니다.
AddIniFile(IConfigurationBuilder, String, Boolean)	path INI 구성 공급자를 builder추가합니다.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	path INI 구성 공급자를 builder추가합니다.
AddIniStream(IConfigurationBuilder, Stream)	builderINI 구성 원본을 추가합니다.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	builderJSON 구성 원본을 추가합니다.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	builderJSON 구성 원본을 추가합니다.
AddJsonFile(IConfigurationBuilder, String)	path JSON 구성 공급자를 builder추가합니다.
AddJsonFile(IConfigurationBuilder, String, Boolean)	path JSON 구성 공급자를 builder추가합니다.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	path JSON 구성 공급자를 builder추가합니다.
AddJsonStream(IConfigurationBuilder, Stream)	builderJSON 구성 원본을 추가합니다.
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)	builderXML 구성 원본을 추가합니다.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	builderXML 구성 원본을 추가합니다.
AddXmlFile(IConfigurationBuilder, String)	path XML 구성 공급자를 builder추가합니다.
AddXmlFile(IConfigurationBuilder, String, Boolean)	path XML 구성 공급자를 builder추가합니다.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	path XML 구성 공급자를 builder추가합니다.
AddXmlStream(IConfigurationBuilder, Stream)	builderXML 구성 원본을 추가합니다.

추가 정보

• .NET 구성