ConfigurationBuilder 클래스

정의

네임스페이스:: Microsoft.Extensions.Configuration

어셈블리:: Microsoft.Extensions.Configuration.dll

패키지:: Microsoft.Extensions.Configuration v11.0.0-preview.4.26230.115

Source:: ConfigurationBuilder.cs

Source:: ConfigurationBuilder.cs

Source:: ConfigurationBuilder.cs

Source:: ConfigurationBuilder.cs

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

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 파일 기능을 바꿀 수 있습니다.

Example

다음 코드 조각은 런타임에 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"
}

생성자

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

속성

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

메서드

Name	Description
Add(IConfigurationSource)	새 구성 원본을 추가합니다.
Build()	에 IConfiguration 등록된 Sources공급자 집합에서 키와 값을 사용하여 빌드합니다.

확장명 메서드

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

적용 대상

추가 정보

.NET의 구성

피드백

이 페이지가 도움이 되었나요?