ConfigurationManager Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje modyfikowalny obiekt konfiguracji. Jest to zarówno IConfigurationBuilder, jak i IConfigurationRoot. W miarę dodawania źródeł aktualizuje bieżący widok konfiguracji. Po wywołaniu IConfigurationBuilder.Build() konfiguracja jest zamrożona.
public ref class ConfigurationManager sealed : IDisposable, Microsoft::Extensions::Configuration::IConfigurationManager, Microsoft::Extensions::Configuration::IConfigurationRootpublic sealed class ConfigurationManager : IDisposable, Microsoft.Extensions.Configuration.IConfigurationManager, Microsoft.Extensions.Configuration.IConfigurationRoottype ConfigurationManager = class
interface IConfigurationManager
interface IConfiguration
interface IConfigurationBuilder
interface IConfigurationRoot
interface IDisposablePublic NotInheritable Class ConfigurationManager
Implements IConfigurationManager, IConfigurationRoot, IDisposable- Dziedziczenie
-
ConfigurationManager
- Implementuje
Uwagi
Jest to zarówno IConfigurationBuilder, jak i IConfigurationRoot. W miarę dodawania źródeł aktualizuje bieżący widok konfiguracji. Po wywołaniu IConfigurationBuilder.Build() konfiguracja jest zamrożona.
Konstruktory
| ConfigurationManager() |
Tworzy pusty obiekt konfiguracji modyfikowalnej, który jest zarówno IConfigurationBuilder, jak i IConfigurationRoot. |
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 zadania zdefiniowane przez aplikację skojarzone z zwalnianiem, wydawaniem lub resetowaniem niezarządzanych zasobów. |
| Equals(Object) |
Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object) |
| GetChildren() |
Pobiera podsekcje bezpośredniej konfiguracji potomnych. |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetSection(String) |
Pobiera podsekcję konfiguracji z określonym kluczem. |
| GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Jawne implementacje interfejsu
| IConfiguration.GetReloadToken() |
Zwraca IChangeToken, których można użyć do obserwowania, kiedy ta konfiguracja zostanie ponownie załadowana. |
| IConfigurationBuilder.Add(IConfigurationSource) |
Dodaje nowe źródło konfiguracji. |
| IConfigurationBuilder.Build() |
Tworzy IConfiguration z kluczami i wartościami z zestawu źródeł zarejestrowanych w Sources. |
| IConfigurationBuilder.Properties |
Pobiera kolekcję klucz-wartość, która może służyć do udostępniania danych między IConfigurationBuilder a zarejestrowanymi źródłami konfiguracji. |
| IConfigurationRoot.Providers |
Pobiera dostawców konfiguracji dla tej konfiguracji. |
| IConfigurationRoot.Reload() |
Wymusza ponowne ładowanie wartości konfiguracji z bazowych wystąpień IConfigurationProvider. |
Metody rozszerzania
| AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String) |
Rejestruje dostawcę konfiguracji dla metadanych aplikacji. |
| AddConfiguration(IConfigurationBuilder, IConfiguration) |
Dodaje istniejącą konfigurację do |
| AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean) |
Dodaje istniejącą konfigurację do |
| AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>) |
Dodaje IConfigurationProvider, który odczytuje wartości konfiguracji z wiersza polecenia. |
| AddCommandLine(IConfigurationBuilder, String[]) |
Dodaje CommandLineConfigurationProvider, który odczytuje wartości konfiguracji z wiersza polecenia. |
| AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>) |
Dodaje 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 powiązanie przez dopasowywanie nazw właściwości do kluczy konfiguracji rekursywnie. |
| 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 powiązanie przez dopasowywanie nazw właściwości do kluczy konfiguracji rekursywnie. |
| 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 powiązanie przez dopasowywanie nazw właściwości do kluczy konfiguracji rekursywnie. |
| 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 powiązanie przez dopasowywanie nazw właściwości do kluczy konfiguracji rekursywnie. |
| 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 IConfiguration. |
| AsEnumerable(IConfiguration, Boolean) |
Pobiera wyliczenie par klucz-wartość w IConfiguration. |
| GetConnectionString(IConfiguration, String) |
Pobiera wartość z określonym kluczem z sekcji |
| GetRequiredSection(IConfiguration, String) |
Pobiera podsekcję konfiguracji, która ma określony klucz. |
| 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 IConfigurationProvider, który odczytuje wartości konfiguracji ze zmiennych środowiskowych. |
| AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>) |
Dodaje IConfigurationProvider, który odczytuje wartości konfiguracji ze zmiennych środowiskowych. |
| AddEnvironmentVariables(IConfigurationBuilder, String) |
Dodaje IConfigurationProvider, który odczytuje wartości konfiguracji ze zmiennych środowiskowych z określonym prefiksem. |
| GetFileLoadExceptionHandler(IConfigurationBuilder) |
Pobiera domyślne IFileProvider, które mają być używane dla dostawców opartych na plikach. |
| GetFileProvider(IConfigurationBuilder) |
Pobiera domyślne IFileProvider, które mają być używane dla dostawców opartych na plikach. |
| SetBasePath(IConfigurationBuilder, String) |
Ustawia element FileProvider dla dostawców opartych na plikach na wartość 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 domyślne IFileProvider, które mają być używane dla dostawców opartych na plikach. |
| AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
Dodaje źródło konfiguracji INI do |
| AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>) |
Dodaje źródło konfiguracji INI do |
| AddIniFile(IConfigurationBuilder, String) |
Dodaje dostawcę konfiguracji INI w |
| AddIniFile(IConfigurationBuilder, String, Boolean) |
Dodaje dostawcę konfiguracji INI w |
| AddIniFile(IConfigurationBuilder, String, Boolean, Boolean) |
Dodaje dostawcę konfiguracji INI w |
| AddIniStream(IConfigurationBuilder, Stream) |
Dodaje źródło konfiguracji INI do |
| AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
Dodaje źródło konfiguracji JSON do |
| AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>) |
Dodaje źródło konfiguracji JSON do |
| AddJsonFile(IConfigurationBuilder, String) |
Dodaje dostawcę konfiguracji JSON w |
| AddJsonFile(IConfigurationBuilder, String, Boolean) |
Dodaje dostawcę konfiguracji JSON w |
| AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean) |
Dodaje dostawcę konfiguracji JSON w |
| AddJsonStream(IConfigurationBuilder, Stream) |
Dodaje źródło konfiguracji JSON do |
| 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 |
| AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>) |
Dodaje dostawcę konfiguracji pamięci do |
| AddUserSecrets(IConfigurationBuilder, Assembly) |
Dodaje źródło konfiguracji wpisów tajnych użytkownika. To wyszukiwanie 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. To wyszukiwanie 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. To wyszukiwanie 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 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 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 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 |
| AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>) |
Dodaje źródło konfiguracji XML do |
| AddXmlFile(IConfigurationBuilder, String) |
Dodaje dostawcę konfiguracji XML pod adresem |
| AddXmlFile(IConfigurationBuilder, String, Boolean) |
Dodaje dostawcę konfiguracji XML pod adresem |
| AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean) |
Dodaje dostawcę konfiguracji XML pod adresem |
| AddXmlStream(IConfigurationBuilder, Stream) |
Dodaje źródło konfiguracji XML do |
