ConfigurationBuilder Sınıf

Tanım

Ad Alanı:

Microsoft.Extensions.Configuration

Bütünleştirilmiş Kod:

Microsoft.Extensions.Configuration.dll

Paket:

Microsoft.Extensions.Configuration v11.0.0-preview.5.26302.115

Kaynak:

ConfigurationBuilder.cs

Uygulamada kullanmak üzere anahtar/değer tabanlı yapılandırma ayarları oluşturur.

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

Devralma

Object

ConfigurationBuilder

Uygulamalar

IConfigurationBuilder

Açıklamalar

Bu sınıfı kullanarak, yapılandırma değerlerini örneğin bir JSON dosyasında depolayabilir ve sonra çalışma zamanında alabilirsiniz. Daha fazla bilgi için bkz . Yapılandırma - temel örnek.

Bir uygulamayı .NET Core 3.1 veya sonraki bir sürüme geçiriyorsanız, uygulamanızı yapılandırmak için daha önce kullanmış olabileceğiniz app.config dosya işlevini değiştirmek için bu sınıfı kullanabilirsiniz.

Example

Aşağıdaki kod parçacığı, çalışma zamanında bir JSON dosyasından dize değeri almak için bir nesne oluşturan ConfigurationBuilder basitleştirilmiş bir uygulama gösterir.

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 dosyasının içeriği burada gösterilir.

{
  "weather": "stormy"
}

Oluşturucular

Name	Description
ConfigurationBuilder()	ConfigurationBuilder sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Properties	ile kayıtlı IConfigurationProvider sağlayıcılar arasında IConfigurationBuilder veri paylaşmak için kullanılabilecek bir anahtar/değer koleksiyonu alır.
Sources	Yapılandırma değerlerini almak için kullanılan kaynakları alır.

Yöntemler

Name	Description
Add(IConfigurationSource)	Yeni bir yapılandırma kaynağı ekler.
Build()	içinde kayıtlı Sourcessağlayıcı kümesinden anahtarlar ve değerlerle bir IConfiguration oluşturur.

Uzantı Metotları

Name	Description
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Yeni bir yapılandırma kaynağı ekler.
AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Uygulama meta verileri için bir yapılandırma sağlayıcısı kaydeder.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Komut satırından yapılandırma değerlerini okuyan bir IConfigurationProvider ekler.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Belirtilen anahtar eşlemelerini kullanarak komut satırından yapılandırma değerlerini okuyan bir CommandLineConfigurationProviderIConfigurationProvider ekler.
AddCommandLine(IConfigurationBuilder, String[])	Komut satırından yapılandırma değerlerini okuyan bir CommandLineConfigurationProviderIConfigurationProvider ekler.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	öğesine var olan bir yapılandırma ekler configurationBuilder.
AddConfiguration(IConfigurationBuilder, IConfiguration)	öğesine var olan bir yapılandırma ekler configurationBuilder.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Ortam değişkenlerinden yapılandırma değerlerini okuyan bir IConfigurationProvider ekler.
AddEnvironmentVariables(IConfigurationBuilder, String)	Belirtilen ön IConfigurationProvider eke sahip ortam değişkenlerinden yapılandırma değerlerini okuyan bir ekler.
AddEnvironmentVariables(IConfigurationBuilder)	Ortam değişkenlerinden yapılandırma değerlerini okuyan bir IConfigurationProvider ekler.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	öğesine builderbir INI yapılandırma kaynağı ekler.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	öğesine builderbir INI yapılandırma kaynağı ekler.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	konumundaki INI yapılandırma sağlayıcısını path öğesine builderekler.
AddIniFile(IConfigurationBuilder, String, Boolean)	konumundaki INI yapılandırma sağlayıcısını path öğesine builderekler.
AddIniFile(IConfigurationBuilder, String)	konumundaki INI yapılandırma sağlayıcısını path öğesine builderekler.
AddIniStream(IConfigurationBuilder, Stream)	öğesine builderbir INI yapılandırma kaynağı ekler.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	bellek yapılandırma sağlayıcısını öğesine configurationBuilderekler.
AddInMemoryCollection(IConfigurationBuilder)	bellek yapılandırma sağlayıcısını öğesine configurationBuilderekler.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	öğesine builderbir JSON yapılandırma kaynağı ekler.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	öğesine builderbir JSON yapılandırma kaynağı ekler.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	konumundaki JSON yapılandırma sağlayıcısını path öğesine builderekler.
AddJsonFile(IConfigurationBuilder, String, Boolean)	konumundaki JSON yapılandırma sağlayıcısını path öğesine builderekler.
AddJsonFile(IConfigurationBuilder, String)	konumundaki JSON yapılandırma sağlayıcısını path öğesine builderekler.
AddJsonStream(IConfigurationBuilder, Stream)	öğesine builderbir JSON yapılandırma kaynağı ekler.
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	Dizinden dosyaları kullanarak yapılandırma ekler. Dosya adları anahtar olarak, dosya içeriği ise değer olarak kullanılır.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)	Dizinden dosyaları kullanarak yapılandırma ekler. Dosya adları anahtar olarak, dosya içeriği ise değer olarak kullanılır.
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	Dizinden dosyaları kullanarak yapılandırma ekler. Dosya adları anahtar olarak, dosya içeriği ise değer olarak kullanılır.
AddKeyPerFile(IConfigurationBuilder, String)	Dizinden dosyaları kullanarak yapılandırma ekler. Dosya adları anahtar olarak, dosya içeriği ise değer olarak kullanılır.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Bu, kullanıcı gizli dizi kimliğini UserSecretsIdAttributebelirten bir örneğini ararassembly. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerlerinin koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Bu, kullanıcı gizli dizi kimliğini UserSecretsIdAttributebelirten bir örneğini ararassembly. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerlerinin koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir.
AddUserSecrets(IConfigurationBuilder, Assembly)	Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Bu, kullanıcı gizli dizi kimliğini UserSecretsIdAttributebelirten bir örneğini ararassembly. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerlerinin koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	Kullanıcı gizli dizileri yapılandırma kaynağını belirtilen kullanıcı gizli dizileri kimliğiyle ekler. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerlerinin koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir.
AddUserSecrets(IConfigurationBuilder, String)	Kullanıcı gizli dizileri yapılandırma kaynağını belirtilen kullanıcı gizli dizileri kimliğiyle ekler. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerlerinin koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Türü içeren T derlemede kullanıcı gizli dizi kimliğini belirten bir örneği UserSecretsIdAttributearar. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerlerinin koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Türü içeren T derlemede kullanıcı gizli dizi kimliğini belirten bir örneği UserSecretsIdAttributearar. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerlerinin koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir.
AddUserSecrets<T>(IConfigurationBuilder)	Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Türü içeren T derlemede kullanıcı gizli dizi kimliğini belirten bir örneği UserSecretsIdAttributearar. Kullanıcı gizli dizileri kimliği, gizli dizi yapılandırma değerlerinin koleksiyonunu depolamak ve tanımlamak için kullanılan benzersiz bir değerdir.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	öğesine builderbir XML yapılandırma kaynağı ekler.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	öğesine builderbir XML yapılandırma kaynağı ekler.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	konumundaki XML yapılandırma sağlayıcısını path öğesine builderekler.
AddXmlFile(IConfigurationBuilder, String, Boolean)	konumundaki XML yapılandırma sağlayıcısını path öğesine builderekler.
AddXmlFile(IConfigurationBuilder, String)	konumundaki XML yapılandırma sağlayıcısını path öğesine builderekler.
AddXmlStream(IConfigurationBuilder, Stream)	öğesine builderbir XML yapılandırma kaynağı ekler.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Bir hata oluştuğunda dosya tabanlı sağlayıcılar için çağrılacak varsayılan eylemi alır.
GetFileProvider(IConfigurationBuilder)	Dosya tabanlı sağlayıcılar için kullanılacak varsayılan IFileProvider değeri alır.
SetBasePath(IConfigurationBuilder, String)	Dosya tabanlı sağlayıcılar için FileProvider'ı temel yolu olan bir PhysicalFileProvider olarak ayarlar.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	Bir hata oluştuğunda dosya tabanlı sağlayıcılar için çağrılacak varsayılan eylemi ayarlar.
SetFileProvider(IConfigurationBuilder, IFileProvider)	Dosya tabanlı sağlayıcılar için kullanılacak varsayılan IFileProvider değeri ayarlar.

Ayrıca bkz.

• .NET'te yapılandırma