ConfigurationManager Sınıf

Başvuru

Tanım

Ad Alanı:: Microsoft.Extensions.Configuration

Bütünleştirilmiş Kod:: Microsoft.Extensions.Configuration.dll

Paket:: Microsoft.Extensions.Configuration v8.0.0

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

Kaynak:: ConfigurationManager.cs

Kaynak:: ConfigurationManager.cs

Kaynak:: ConfigurationManager.cs

Kaynak:: ConfigurationManager.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Değiştirilebilir yapılandırma nesnesini temsil eder. Hem IConfigurationBuilder hem de IConfigurationRoot. Kaynaklar eklendikçe, yapılandırmanın geçerli görünümünü güncelleştirir. IConfigurationBuilder.Build() çağrıldıktan sonra yapılandırma dondurulur.

public ref class ConfigurationManager sealed : IDisposable, Microsoft::Extensions::Configuration::IConfigurationManager, Microsoft::Extensions::Configuration::IConfigurationRoot

public sealed class ConfigurationManager : IDisposable, Microsoft.Extensions.Configuration.IConfigurationManager, Microsoft.Extensions.Configuration.IConfigurationRoot

type ConfigurationManager = class
    interface IConfigurationManager
    interface IConfiguration
    interface IConfigurationBuilder
    interface IConfigurationRoot
    interface IDisposable

Public NotInheritable Class ConfigurationManager
Implements IConfigurationManager, IConfigurationRoot, IDisposable

Devralma: Object
ConfigurationManager

Uygulamalar: IConfiguration IConfigurationBuilder IConfigurationManager IConfigurationRoot IDisposable

Açıklamalar

Hem IConfigurationBuilder hem de IConfigurationRoot. Kaynaklar eklendikçe geçerli yapılandırma görünümünü güncelleştirir. IConfigurationBuilder.Build() çağrıldıktan sonra yapılandırma dondurulur.

Oluşturucular

ConfigurationManager()

hem IConfigurationBuilder hem de IConfigurationRootolan boş bir değiştirilebilir yapılandırma nesnesi oluşturur.

Özellikler

Item[String]	Yapılandırma değerini alır veya ayarlar.
Sources	Yapılandırma değerlerini almak için kullanılan kaynakları alır.

Yöntemler

Dispose()	Yönetilmeyen kaynakları serbest bırakma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetChildren()	Hemen alt yapılandırma alt bölümlerini alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetSection(String)	Belirtilen anahtarla bir yapılandırma alt bölümü alır.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IConfiguration.GetReloadToken()	Bu yapılandırma yeniden yüklendiğinde gözlemlemek için kullanılabilecek bir IChangeToken döndürür.
IConfigurationBuilder.Add(IConfigurationSource)	Yeni bir yapılandırma kaynağı ekler.
IConfigurationBuilder.Build()	Sources'de kayıtlı kaynak kümesindeki anahtarlar ve değerlerle bir IConfiguration oluşturur.
IConfigurationBuilder.Properties	IConfigurationBuilder ve kayıtlı yapılandırma kaynakları arasında veri paylaşmak için kullanılabilecek bir anahtar-değer koleksiyonu alır.
IConfigurationRoot.Providers	Bu yapılandırma için yapılandırma sağlayıcılarını alır.
IConfigurationRoot.Reload()	Yapılandırma değerlerini temel alınan IConfigurationProvider örneklerinden yeniden yüklenmeye zorlar.

Uzantı Metotları

AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Uygulama meta verileri için bir yapılandırma sağlayıcısı kaydeder.
AddConfiguration(IConfigurationBuilder, IConfiguration)	`configurationBuilder`var olan bir yapılandırma ekler.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	`configurationBuilder`var olan bir yapılandırma ekler.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Komut satırından yapılandırma değerlerini okuyan bir IConfigurationProvider ekler.
AddCommandLine(IConfigurationBuilder, String[])	Komut satırından yapılandırma değerlerini okuyan bir CommandLineConfigurationProvider ekler.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Belirtilen anahtar eşlemelerini kullanarak komut satırından yapılandırma değerlerini okuyan bir CommandLineConfigurationProvider ekler.
Bind(IConfiguration, Object)	Özellik adlarını yapılandırma anahtarlarıyla özyinelemeli olarak eşleştirerek verilen nesne örneğini yapılandırma değerlerine bağlamaya çalışır.
Bind(IConfiguration, Object, Action<BinderOptions>)	Özellik adlarını yapılandırma anahtarlarıyla özyinelemeli olarak eşleştirerek verilen nesne örneğini yapılandırma değerlerine bağlamaya çalışır.
Bind(IConfiguration, String, Object)	Özellik adlarını yapılandırma anahtarlarıyla özyinelemeli olarak eşleştirerek verilen nesne örneğini anahtar tarafından belirtilen yapılandırma bölümüne bağlamaya çalışır.
Get(IConfiguration, Type)	Yapılandırma örneğini T türünün yeni bir örneğine bağlamayı dener. Bu yapılandırma bölümü bir değere sahipse, kullanılacaktır. Aksi takdirde, özellik adlarını yapılandırma anahtarlarıyla özyinelemeli olarak eşleştirerek bağlama.
Get(IConfiguration, Type, Action<BinderOptions>)	Yapılandırma örneğini T türünün yeni bir örneğine bağlamayı dener. Bu yapılandırma bölümü bir değere sahipse, kullanılacaktır. Aksi takdirde, özellik adlarını yapılandırma anahtarlarıyla özyinelemeli olarak eşleştirerek bağlama.
Get<T>(IConfiguration)	Yapılandırma örneğini T türünün yeni bir örneğine bağlamayı dener. Bu yapılandırma bölümü bir değere sahipse, kullanılacaktır. Aksi takdirde, özellik adlarını yapılandırma anahtarlarıyla özyinelemeli olarak eşleştirerek bağlama.
Get<T>(IConfiguration, Action<BinderOptions>)	Yapılandırma örneğini T türünün yeni bir örneğine bağlamayı dener. Bu yapılandırma bölümü bir değere sahipse, kullanılacaktır. Aksi takdirde, özellik adlarını yapılandırma anahtarlarıyla özyinelemeli olarak eşleştirerek bağlama.
GetValue(IConfiguration, Type, String)	Değeri belirtilen anahtarla ayıklar ve belirtilen türe dönüştürür.
GetValue(IConfiguration, Type, String, Object)	Değeri belirtilen anahtarla ayıklar ve belirtilen türe dönüştürür.
GetValue<T>(IConfiguration, String)	Belirtilen anahtarla değeri ayıklar ve T türüne dönüştürür.
GetValue<T>(IConfiguration, String, T)	Belirtilen anahtarla değeri ayıklar ve T türüne dönüştürür.
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Yeni bir yapılandırma kaynağı ekler.
AsEnumerable(IConfiguration)	IConfigurationiçinde anahtar-değer çiftlerinin numaralandırmasını alın.
AsEnumerable(IConfiguration, Boolean)	IConfigurationiçindeki anahtar-değer çiftlerinin numaralandırmasını alır.
GetConnectionString(IConfiguration, String)	Belirtilen anahtara sahip değeri yapılandırma kaynağının `ConnectionStrings` bölümünden alır. Bu yöntemi çağırmak `GetSection("ConnectionStrings")[name]`için kısaltmadır.
GetRequiredSection(IConfiguration, String)	Belirtilen anahtarı içeren yapılandırma alt bölümü alır.
GetDebugView(IConfigurationRoot)	Her değerin nereden geldiğini gösteren, yapılandırmanın okunabilir bir görünümünü oluşturur.
GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>)	Her değerin nereden geldiğini gösteren, yapılandırmanın okunabilir bir görünümünü oluşturur.
AddEnvironmentVariables(IConfigurationBuilder)	Ortam değişkenlerinden yapılandırma değerlerini okuyan bir IConfigurationProvider ekler.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Ortam değişkenlerinden yapılandırma değerlerini okuyan bir IConfigurationProvider ekler.
AddEnvironmentVariables(IConfigurationBuilder, String)	Belirtilen ön eke sahip ortam değişkenlerinden yapılandırma değerlerini okuyan bir IConfigurationProvider ekler.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Dosya tabanlı sağlayıcılar için kullanılacak varsayılan IFileProvider alır.
GetFileProvider(IConfigurationBuilder)	Dosya tabanlı sağlayıcılar için kullanılacak varsayılan IFileProvider 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 ayarlar.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	`builder`bir INI yapılandırma kaynağı ekler.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	`builder`bir INI yapılandırma kaynağı ekler.
AddIniFile(IConfigurationBuilder, String)	`path` ini yapılandırma sağlayıcısını `builder`ekler.
AddIniFile(IConfigurationBuilder, String, Boolean)	`path` ini yapılandırma sağlayıcısını `builder`ekler.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	`path` ini yapılandırma sağlayıcısını `builder`ekler.
AddIniStream(IConfigurationBuilder, Stream)	`builder`bir INI yapılandırma kaynağı ekler.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	`builder`bir JSON yapılandırma kaynağı ekler.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	`builder`bir JSON yapılandırma kaynağı ekler.
AddJsonFile(IConfigurationBuilder, String)	`path`'daki JSON yapılandırma sağlayıcısını `builder`ekler.
AddJsonFile(IConfigurationBuilder, String, Boolean)	`path`'daki JSON yapılandırma sağlayıcısını `builder`ekler.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	`path`'daki JSON yapılandırma sağlayıcısını `builder`ekler.
AddJsonStream(IConfigurationBuilder, Stream)	`builder`bir 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)	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, Boolean, Boolean)	Dizinden dosyaları kullanarak yapılandırma ekler. Dosya adları anahtar olarak, dosya içeriği ise değer olarak kullanılır.
AddInMemoryCollection(IConfigurationBuilder)	bellek yapılandırma sağlayıcısını `configurationBuilder`ekler.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	bellek yapılandırma sağlayıcısını `configurationBuilder`ekler.
AddUserSecrets(IConfigurationBuilder, Assembly)	Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Bu, `assembly` kullanıcı gizli dizi kimliğini belirten UserSecretsIdAttributeörneğini arar. 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, `assembly` kullanıcı gizli dizi kimliğini belirten UserSecretsIdAttributeörneğini arar. 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, Boolean)	Kullanıcı gizli dizileri yapılandırma kaynağını ekler. Bu, `assembly` kullanıcı gizli dizi kimliğini belirten UserSecretsIdAttributeörneğini arar. 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(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<T>(IConfigurationBuilder)	Kullanıcı gizli dizileri yapılandırma kaynağını ekler. `T` türü içeren derlemede kullanıcı gizli dizi kimliğini belirten UserSecretsIdAttributeörneğini arar. 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` türü içeren derlemede kullanıcı gizli dizi kimliğini belirten UserSecretsIdAttributeörneğini arar. 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` türü içeren derlemede kullanıcı gizli dizi kimliğini belirten UserSecretsIdAttributeörneğini arar. 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, IFileProvider, String, Boolean, Boolean)	`builder`bir XML yapılandırma kaynağı ekler.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	`builder`bir XML yapılandırma kaynağı ekler.
AddXmlFile(IConfigurationBuilder, String)	`path`'daki XML yapılandırma sağlayıcısını `builder`ekler.
AddXmlFile(IConfigurationBuilder, String, Boolean)	`path`'daki XML yapılandırma sağlayıcısını `builder`ekler.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	`path`'daki XML yapılandırma sağlayıcısını `builder`ekler.
AddXmlStream(IConfigurationBuilder, Stream)	`builder`bir XML yapılandırma kaynağı ekler.

Şunlara uygulanır

Aracılığıyla paylaş