ConfigurationManager Třída

Definice

Obor názvů:

Microsoft.Extensions.Configuration

Sestavení:

Microsoft.Extensions.Configuration.dll

Balíček:

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

Zdroj:

ConfigurationManager.cs

Představuje proměnlivý objekt konfigurace. Je to IConfigurationBuilder i IConfigurationRoot. Při přidání zdrojů aktualizuje aktuální zobrazení konfigurace. Po zavolání IConfigurationBuilder.Build() se konfigurace zablokuje.

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

Dědičnost

Object

ConfigurationManager

Implementuje

IConfiguration IConfigurationBuilder IConfigurationManager IConfigurationRoot IDisposable

Poznámky

Je to IConfigurationBuilder i IConfigurationRoot. Při přidání zdrojů aktualizuje aktuální zobrazení konfigurace. Po zavolání IConfigurationBuilder.Build() se konfigurace zablokuje.

Konstruktory

ConfigurationManager()

Vytvoří prázdný proměnlivý konfigurační objekt, který je IConfigurationBuilder i IConfigurationRoot.

Vlastnosti

Item[String]	Získá nebo nastaví hodnotu konfigurace.
Sources	Získá zdroje používané k získání hodnot konfigurace.

Metody

Dispose()	Provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetChildren()	Získá dílčí části konfigurace okamžitého potomka.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetSection(String)	Získá pododdíl konfigurace se zadaným klíčem.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

IConfiguration.GetReloadToken()	Vrátí IChangeToken, který lze použít k pozorování při opětovném načtení této konfigurace.
IConfigurationBuilder.Add(IConfigurationSource)	Přidá nový zdroj konfigurace.
IConfigurationBuilder.Build()	Vytvoří IConfiguration s klíči a hodnotami ze sady zdrojů registrovaných v Sources.
IConfigurationBuilder.Properties	Získá kolekci klíč-hodnota, která lze použít ke sdílení dat mezi IConfigurationBuilder a registrovanými zdroji konfigurace.
IConfigurationRoot.Providers	Získá zprostředkovatele konfigurace pro tuto konfiguraci.
IConfigurationRoot.Reload()	Vynutí opětovné načtení hodnot konfigurace z podkladových IConfigurationProvider instancí.

Metody rozšíření

AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Zaregistruje zprostředkovatele konfigurace pro metadata aplikace.
AddConfiguration(IConfigurationBuilder, IConfiguration)	Přidá existující konfiguraci do configurationBuilder.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	Přidá existující konfiguraci do configurationBuilder.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Přidá IConfigurationProvider, která čte konfigurační hodnoty z příkazového řádku.
AddCommandLine(IConfigurationBuilder, String[])	Přidá CommandLineConfigurationProvider, která čte konfigurační hodnoty z příkazového řádku.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Přidá CommandLineConfigurationProvider, která čte konfigurační hodnoty z příkazového řádku pomocí zadaných mapování přepínačů.
Bind(IConfiguration, Object)	Pokusí se svázat danou instanci objektu s konfiguračními hodnotami odpovídajícími názvy vlastností proti konfiguračním klíčům rekurzivně.
Bind(IConfiguration, Object, Action<BinderOptions>)	Pokusí se svázat danou instanci objektu s konfiguračními hodnotami odpovídajícími názvy vlastností proti konfiguračním klíčům rekurzivně.
Bind(IConfiguration, String, Object)	Pokusí se svázat danou instanci objektu s částí konfigurace určenou klíčem odpovídajícími názvy vlastností proti konfiguračním klíčům rekurzivně.
Get(IConfiguration, Type)	Pokusí se vytvořit vazbu instance konfigurace na novou instanci typu T. Pokud má tato část konfigurace hodnotu, použije se. V opačném případě vazby odpovídajícími názvy vlastností proti konfiguračním klíčům rekurzivně.
Get(IConfiguration, Type, Action<BinderOptions>)	Pokusí se vytvořit vazbu instance konfigurace na novou instanci typu T. Pokud má tato část konfigurace hodnotu, použije se. V opačném případě vazby odpovídajícími názvy vlastností proti konfiguračním klíčům rekurzivně.
Get<T>(IConfiguration)	Pokusí se vytvořit vazbu instance konfigurace na novou instanci typu T. Pokud má tato část konfigurace hodnotu, použije se. V opačném případě vazby odpovídajícími názvy vlastností proti konfiguračním klíčům rekurzivně.
Get<T>(IConfiguration, Action<BinderOptions>)	Pokusí se vytvořit vazbu instance konfigurace na novou instanci typu T. Pokud má tato část konfigurace hodnotu, použije se. V opačném případě vazby odpovídajícími názvy vlastností proti konfiguračním klíčům rekurzivně.
GetValue(IConfiguration, Type, String)	Extrahuje hodnotu se zadaným klíčem a převede ji na zadaný typ.
GetValue(IConfiguration, Type, String, Object)	Extrahuje hodnotu se zadaným klíčem a převede ji na zadaný typ.
GetValue<T>(IConfiguration, String)	Extrahuje hodnotu se zadaným klíčem a převede ji na typ T.
GetValue<T>(IConfiguration, String, T)	Extrahuje hodnotu se zadaným klíčem a převede ji na typ T.
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Přidá nový zdroj konfigurace.
AsEnumerable(IConfiguration)	Získejte výčet párů klíč-hodnota v rámci IConfiguration.
AsEnumerable(IConfiguration, Boolean)	Získá výčet párů klíč-hodnota v rámci IConfiguration.
GetConnectionString(IConfiguration, String)	Načte hodnotu se zadaným klíčem z oddílu ConnectionStrings zdroje konfigurace. Volání této metody je zkratka pro GetSection("ConnectionStrings")[name].
GetRequiredSection(IConfiguration, String)	Získá pododdíl konfigurace, který má zadaný klíč.
GetDebugView(IConfigurationRoot)	Vygeneruje zobrazení konfigurace čitelné pro člověka, které ukazuje, odkud každá hodnota pochází.
GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>)	Vygeneruje zobrazení konfigurace čitelné pro člověka, které ukazuje, odkud každá hodnota pochází.
AddEnvironmentVariables(IConfigurationBuilder)	Přidá IConfigurationProvider, která čte konfigurační hodnoty z proměnných prostředí.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Přidá IConfigurationProvider, která čte konfigurační hodnoty z proměnných prostředí.
AddEnvironmentVariables(IConfigurationBuilder, String)	Přidá IConfigurationProvider, která čte konfigurační hodnoty z proměnných prostředí se zadanou předponou.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Získá výchozí IFileProvider použít pro zprostředkovatele založené na souborech.
GetFileProvider(IConfigurationBuilder)	Získá výchozí IFileProvider použít pro zprostředkovatele založené na souborech.
SetBasePath(IConfigurationBuilder, String)	Nastaví FileProvider pro zprostředkovatele založené na souborech na PhysicalFileProvider se základní cestou.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	Nastaví výchozí akci, která se má vyvolat u zprostředkovatelů založených na souborech, když dojde k chybě.
SetFileProvider(IConfigurationBuilder, IFileProvider)	Nastaví výchozí IFileProvider, které se použijí pro zprostředkovatele založené na souborech.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Přidá zdroj konfigurace INI do builder.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	Přidá zdroj konfigurace INI do builder.
AddIniFile(IConfigurationBuilder, String)	Přidá zprostředkovatele konfigurace INI v path do builder.
AddIniFile(IConfigurationBuilder, String, Boolean)	Přidá zprostředkovatele konfigurace INI v path do builder.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	Přidá zprostředkovatele konfigurace INI v path do builder.
AddIniStream(IConfigurationBuilder, Stream)	Přidá zdroj konfigurace INI do builder.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Přidá zdroj konfigurace JSON do builder.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	Přidá zdroj konfigurace JSON do builder.
AddJsonFile(IConfigurationBuilder, String)	Přidá zprostředkovatele konfigurace JSON v path do builder.
AddJsonFile(IConfigurationBuilder, String, Boolean)	Přidá zprostředkovatele konfigurace JSON v path do builder.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	Přidá zprostředkovatele konfigurace JSON v path do builder.
AddJsonStream(IConfigurationBuilder, Stream)	Přidá zdroj konfigurace JSON do builder.
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	Přidá konfiguraci pomocí souborů z adresáře. Názvy souborů se používají jako klíč, obsah souboru se používá jako hodnota.
AddKeyPerFile(IConfigurationBuilder, String)	Přidá konfiguraci pomocí souborů z adresáře. Názvy souborů se používají jako klíč, obsah souboru se používá jako hodnota.
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	Přidá konfiguraci pomocí souborů z adresáře. Názvy souborů se používají jako klíč, obsah souboru se používá jako hodnota.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)	Přidá konfiguraci pomocí souborů z adresáře. Názvy souborů se používají jako klíč, obsah souboru se používá jako hodnota.
AddInMemoryCollection(IConfigurationBuilder)	Přidá zprostředkovatele konfigurace paměti do configurationBuilder.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	Přidá zprostředkovatele konfigurace paměti do configurationBuilder.
AddUserSecrets(IConfigurationBuilder, Assembly)	Přidá zdroj konfigurace tajných kódů uživatele. Vyhledá assembly instanci UserSecretsIdAttribute, která určuje ID tajných kódů uživatele. ID tajných kódů uživatele je jedinečná hodnota použitá k ukládání a identifikaci kolekce hodnot konfigurace tajných kódů.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	Přidá zdroj konfigurace tajných kódů uživatele. Vyhledá assembly instanci UserSecretsIdAttribute, která určuje ID tajných kódů uživatele. ID tajných kódů uživatele je jedinečná hodnota použitá k ukládání a identifikaci kolekce hodnot konfigurace tajných kódů.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Přidá zdroj konfigurace tajných kódů uživatele. Vyhledá assembly instanci UserSecretsIdAttribute, která určuje ID tajných kódů uživatele. ID tajných kódů uživatele je jedinečná hodnota použitá k ukládání a identifikaci kolekce hodnot konfigurace tajných kódů.
AddUserSecrets(IConfigurationBuilder, String)	Přidá zdroj konfigurace tajných kódů uživatele se zadaným ID tajných kódů uživatele. ID tajných kódů uživatele je jedinečná hodnota použitá k ukládání a identifikaci kolekce hodnot konfigurace tajných kódů.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	Přidá zdroj konfigurace tajných kódů uživatele se zadaným ID tajných kódů uživatele. ID tajných kódů uživatele je jedinečná hodnota použitá k ukládání a identifikaci kolekce hodnot konfigurace tajných kódů.
AddUserSecrets<T>(IConfigurationBuilder)	Přidá zdroj konfigurace tajných kódů uživatele. Vyhledá sestavení obsahující typ T instanci UserSecretsIdAttribute, která určuje ID tajných kódů uživatele. ID tajných kódů uživatele je jedinečná hodnota použitá k ukládání a identifikaci kolekce hodnot konfigurace tajných kódů.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	Přidá zdroj konfigurace tajných kódů uživatele. Vyhledá sestavení obsahující typ T instanci UserSecretsIdAttribute, která určuje ID tajných kódů uživatele. ID tajných kódů uživatele je jedinečná hodnota použitá k ukládání a identifikaci kolekce hodnot konfigurace tajných kódů.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	Přidá zdroj konfigurace tajných kódů uživatele. Vyhledá sestavení obsahující typ T instanci UserSecretsIdAttribute, která určuje ID tajných kódů uživatele. ID tajných kódů uživatele je jedinečná hodnota použitá k ukládání a identifikaci kolekce hodnot konfigurace tajných kódů.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Přidá zdroj konfigurace XML do builder.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	Přidá zdroj konfigurace XML do builder.
AddXmlFile(IConfigurationBuilder, String)	Přidá zprostředkovatele konfigurace XML v path do builder.
AddXmlFile(IConfigurationBuilder, String, Boolean)	Přidá zprostředkovatele konfigurace XML v path do builder.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	Přidá zprostředkovatele konfigurace XML v path do builder.
AddXmlStream(IConfigurationBuilder, Stream)	Přidá zdroj konfigurace XML do builder.