ConfigurationManager Klasa

Definicja

Przestrzeń nazw:

Microsoft.Extensions.Configuration

Zestaw:

Microsoft.Extensions.Configuration.dll

Pakiet:

Microsoft.Extensions.Configuration v8.0.0

Źródło:

ConfigurationManager.cs

Reprezentuje modyfikowalny obiekt konfiguracji. Jest to zarówno element , jak IConfigurationBuilderIConfigurationRooti . W miarę dodawania źródeł aktualizuje bieżący widok konfiguracji. Po IConfigurationBuilder.Build() wywołaniu konfiguracja jest zamrożona.

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

Dziedziczenie

Object

ConfigurationManager

Implementuje

IConfiguration IConfigurationBuilder IConfigurationRoot IDisposable IConfigurationManager

Uwagi

Jest to zarówno element , jak IConfigurationBuilderIConfigurationRooti . W miarę dodawania źródeł aktualizuje bieżący widok konfiguracji.

Konstruktory

ConfigurationManager()

Tworzy pusty obiekt konfiguracji modyfikowalnej, który jest zarówno obiektem , jak IConfigurationBuilderIConfigurationRooti .

Właściwości

Item[String]	Pobiera lub ustawia wartość konfiguracji.
Sources	Pobiera źródła używane do uzyskiwania wartości konfiguracji.

Metody

Dispose()	Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetChildren()	Pobiera podsekcje bezpośredniej konfiguracji podrzędnej.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetSection(String)	Pobiera podsekcję konfiguracji z określonym kluczem.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IConfiguration.GetReloadToken()	Zwraca wartość IChangeToken , która może służyć do obserwowania ponownego załadowania tej konfiguracji.
IConfigurationBuilder.Add(IConfigurationSource)	Dodaje nowe źródło konfiguracji.
IConfigurationBuilder.Build()	Tworzy element IConfiguration z kluczami i wartościami z zestawu źródeł zarejestrowanych w programie Sources.
IConfigurationBuilder.Properties	Pobiera kolekcję klucz-wartość, która może służyć do udostępniania danych między źródłami IConfigurationBuilder konfiguracji i zarejestrowanymi źródłami konfiguracji.
IConfigurationRoot.Providers	Pobiera dostawców konfiguracji dla tej konfiguracji.
IConfigurationRoot.Reload()	Wymusza ponowne załadowanie wartości konfiguracji z bazowych IConfigurationProvider wystąpień.

Metody rozszerzania

AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Rejestruje dostawcę konfiguracji dla metadanych aplikacji.
AddConfiguration(IConfigurationBuilder, IConfiguration)	Dodaje istniejącą konfigurację do configurationBuilderelementu .
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	Dodaje istniejącą konfigurację do configurationBuilderelementu .
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Dodaje element IConfigurationProvider , który odczytuje wartości konfiguracji z wiersza polecenia.
AddCommandLine(IConfigurationBuilder, String[])	Dodaje element CommandLineConfigurationProvider , który odczytuje wartości konfiguracji z wiersza polecenia.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Dodaje element CommandLineConfigurationProvider , który odczytuje wartości konfiguracji z wiersza polecenia przy użyciu określonych mapowań przełącznika.
Bind(IConfiguration, Object)	Próbuje powiązać dane wystąpienie obiektu z wartościami konfiguracji przez rekursywne dopasowywanie nazw właściwości do kluczy konfiguracji.
Bind(IConfiguration, Object, Action<BinderOptions>)	Próbuje powiązać dane wystąpienie obiektu z wartościami konfiguracji przez rekursywne dopasowywanie nazw właściwości do kluczy konfiguracji.
Bind(IConfiguration, String, Object)	Próbuje powiązać dane wystąpienie obiektu z sekcją konfiguracji określoną przez klucz przez rekursywne dopasowywanie nazw właściwości do kluczy konfiguracji.
Get(IConfiguration, Type)	Próbuje powiązać wystąpienie konfiguracji z nowym wystąpieniem typu T. Jeśli ta sekcja konfiguracji ma wartość, zostanie użyta. W przeciwnym razie wiązanie przez rekursywne dopasowywanie nazw właściwości do kluczy konfiguracji.
Get(IConfiguration, Type, Action<BinderOptions>)	Próbuje powiązać wystąpienie konfiguracji z nowym wystąpieniem typu T. Jeśli ta sekcja konfiguracji ma wartość, zostanie użyta. W przeciwnym razie wiązanie przez rekursywne dopasowywanie nazw właściwości do kluczy konfiguracji.
Get<T>(IConfiguration)	Próbuje powiązać wystąpienie konfiguracji z nowym wystąpieniem typu T. Jeśli ta sekcja konfiguracji ma wartość, zostanie użyta. W przeciwnym razie wiązanie przez rekursywne dopasowywanie nazw właściwości do kluczy konfiguracji.
Get<T>(IConfiguration, Action<BinderOptions>)	Próbuje powiązać wystąpienie konfiguracji z nowym wystąpieniem typu T. Jeśli ta sekcja konfiguracji ma wartość, zostanie użyta. W przeciwnym razie wiązanie przez rekursywne dopasowywanie nazw właściwości do kluczy konfiguracji.
GetValue(IConfiguration, Type, String)	Wyodrębnia wartość z określonym kluczem i konwertuje ją na określony typ.
GetValue(IConfiguration, Type, String, Object)	Wyodrębnia wartość z określonym kluczem i konwertuje ją na określony typ.
GetValue<T>(IConfiguration, String)	Wyodrębnia wartość z określonym kluczem i konwertuje ją na typ T.
GetValue<T>(IConfiguration, String, T)	Wyodrębnia wartość z określonym kluczem i konwertuje ją na typ T.
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Dodaje nowe źródło konfiguracji.
AsEnumerable(IConfiguration)	Pobierz wyliczenie par klucz-wartość w obrębie .IConfiguration
AsEnumerable(IConfiguration, Boolean)	Pobiera wyliczenie par klucz-wartość w obrębie .IConfiguration
GetConnectionString(IConfiguration, String)	Pobiera wartość z określonym kluczem z ConnectionStrings sekcji źródła konfiguracji. Wywoływanie tej metody jest skrótem dla metody GetSection("ConnectionStrings")[name].
GetRequiredSection(IConfiguration, String)	Pobiera podsekcję konfiguracji z określonym kluczem.
GetDebugView(IConfigurationRoot)	Generuje czytelny dla człowieka widok konfiguracji pokazujący, skąd pochodzą poszczególne wartości.
GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>)	Generuje czytelny dla człowieka widok konfiguracji pokazujący, skąd pochodzą poszczególne wartości.
AddEnvironmentVariables(IConfigurationBuilder)	Dodaje element IConfigurationProvider , który odczytuje wartości konfiguracji ze zmiennych środowiskowych.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Dodaje element IConfigurationProvider , który odczytuje wartości konfiguracji ze zmiennych środowiskowych.
AddEnvironmentVariables(IConfigurationBuilder, String)	Dodaje element IConfigurationProvider , który odczytuje wartości konfiguracji ze zmiennych środowiskowych z określonym prefiksem.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Pobiera wartość domyślną IFileProvider , która ma być używana dla dostawców opartych na plikach.
GetFileProvider(IConfigurationBuilder)	Pobiera wartość domyślną IFileProvider , która ma być używana dla dostawców opartych na plikach.
SetBasePath(IConfigurationBuilder, String)	Ustawia element FileProvider dla dostawców opartych na plikach na element PhysicalFileProvider ze ścieżką podstawową.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	Ustawia domyślną akcję, która ma być wywoływana dla dostawców opartych na plikach w przypadku wystąpienia błędu.
SetFileProvider(IConfigurationBuilder, IFileProvider)	Ustawia wartość domyślną IFileProvider , która ma być używana dla dostawców opartych na plikach.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Dodaje źródło konfiguracji INI do elementu builder.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	Dodaje źródło konfiguracji INI do elementu builder.
AddIniFile(IConfigurationBuilder, String)	Dodaje dostawcę konfiguracji INI pod adresem path .builder
AddIniFile(IConfigurationBuilder, String, Boolean)	Dodaje dostawcę konfiguracji INI pod adresem path .builder
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	Dodaje dostawcę konfiguracji INI pod adresem path .builder
AddIniStream(IConfigurationBuilder, Stream)	Dodaje źródło konfiguracji INI do elementu builder.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Dodaje źródło konfiguracji JSON do elementu builder.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	Dodaje źródło konfiguracji JSON do elementu builder.
AddJsonFile(IConfigurationBuilder, String)	Dodaje dostawcę konfiguracji JSON pod adresem path .builder
AddJsonFile(IConfigurationBuilder, String, Boolean)	Dodaje dostawcę konfiguracji JSON pod adresem path .builder
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	Dodaje dostawcę konfiguracji JSON pod adresem path .builder
AddJsonStream(IConfigurationBuilder, Stream)	Dodaje źródło konfiguracji JSON do elementu builder.
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	Dodaje konfigurację przy użyciu plików z katalogu. Nazwy plików są używane jako klucz, zawartość pliku jest używana jako wartość.
AddKeyPerFile(IConfigurationBuilder, String)	Dodaje konfigurację przy użyciu plików z katalogu. Nazwy plików są używane jako klucz, zawartość pliku jest używana jako wartość.
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	Dodaje konfigurację przy użyciu plików z katalogu. Nazwy plików są używane jako klucz, zawartość pliku jest używana jako wartość.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)	Dodaje konfigurację przy użyciu plików z katalogu. Nazwy plików są używane jako klucz, zawartość pliku jest używana jako wartość.
AddInMemoryCollection(IConfigurationBuilder)	Dodaje dostawcę konfiguracji pamięci do programu configurationBuilder.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	Dodaje dostawcę konfiguracji pamięci do programu configurationBuilder.
AddUserSecrets(IConfigurationBuilder, Assembly)	Dodaje źródło konfiguracji wpisów tajnych użytkownika. Spowoduje to wyszukanie assembly wystąpienia elementu UserSecretsIdAttribute, które określa identyfikator wpisów tajnych użytkownika. Identyfikator wpisów tajnych użytkownika jest unikatową wartością używaną do przechowywania i identyfikowania kolekcji wartości konfiguracji wpisu tajnego.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	Dodaje źródło konfiguracji wpisów tajnych użytkownika. Spowoduje to wyszukanie assembly wystąpienia elementu UserSecretsIdAttribute, które określa identyfikator wpisów tajnych użytkownika. Identyfikator wpisów tajnych użytkownika jest unikatową wartością używaną do przechowywania i identyfikowania kolekcji wartości konfiguracji wpisu tajnego.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Dodaje źródło konfiguracji wpisów tajnych użytkownika. Spowoduje to wyszukanie assembly wystąpienia elementu UserSecretsIdAttribute, które określa identyfikator wpisów tajnych użytkownika. Identyfikator wpisów tajnych użytkownika jest unikatową wartością używaną do przechowywania i identyfikowania kolekcji wartości konfiguracji wpisu tajnego.
AddUserSecrets(IConfigurationBuilder, String)	Dodaje źródło konfiguracji wpisów tajnych użytkownika z określonym identyfikatorem wpisów tajnych użytkownika. Identyfikator wpisów tajnych użytkownika jest unikatową wartością używaną do przechowywania i identyfikowania kolekcji wartości konfiguracji wpisu tajnego.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	Dodaje źródło konfiguracji wpisów tajnych użytkownika z określonym identyfikatorem wpisów tajnych użytkownika. Identyfikator wpisów tajnych użytkownika jest unikatową wartością używaną do przechowywania i identyfikowania kolekcji wartości konfiguracji wpisu tajnego.
AddUserSecrets<T>(IConfigurationBuilder)	Dodaje źródło konfiguracji wpisów tajnych użytkownika. Wyszukuje zestaw zawierający typ T wystąpienia UserSecretsIdAttributeelementu , który określa identyfikator wpisów tajnych użytkownika. Identyfikator wpisów tajnych użytkownika jest unikatową wartością używaną do przechowywania i identyfikowania kolekcji wartości konfiguracji wpisu tajnego.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	Dodaje źródło konfiguracji wpisów tajnych użytkownika. Wyszukuje zestaw zawierający typ T wystąpienia UserSecretsIdAttributeelementu , który określa identyfikator wpisów tajnych użytkownika. Identyfikator wpisów tajnych użytkownika jest unikatową wartością używaną do przechowywania i identyfikowania kolekcji wartości konfiguracji wpisu tajnego.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	Dodaje źródło konfiguracji wpisów tajnych użytkownika. Wyszukuje zestaw zawierający typ T wystąpienia UserSecretsIdAttributeelementu , który określa identyfikator wpisów tajnych użytkownika. Identyfikator wpisów tajnych użytkownika jest unikatową wartością używaną do przechowywania i identyfikowania kolekcji wartości konfiguracji wpisu tajnego.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Dodaje źródło konfiguracji XML do elementu builder.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	Dodaje źródło konfiguracji XML do elementu builder.
AddXmlFile(IConfigurationBuilder, String)	Dodaje dostawcę konfiguracji XML pod adresem path .builder
AddXmlFile(IConfigurationBuilder, String, Boolean)	Dodaje dostawcę konfiguracji XML pod adresem path .builder
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	Dodaje dostawcę konfiguracji XML pod adresem path .builder
AddXmlStream(IConfigurationBuilder, Stream)	Dodaje źródło konfiguracji XML do elementu builder.