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 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
-
ConfigurationManager
- Implementuje
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 IConfigurationBuilder 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 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 bezpośrednie podsekcje konfiguracji elementów podrzędnych. |
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 Sourcesprogramie . |
IConfigurationBuilder.Properties |
Pobiera kolekcję klucz-wartość, która może służyć do udostępniania danych między IConfigurationBuilder źródłami 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 |
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean) |
Dodaje istniejącą konfigurację do |
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ć podane wystąpienie obiektu z wartościami konfiguracji, pasując nazwy właściwości do kluczy konfiguracji cyklicznie. |
Bind(IConfiguration, Object, Action<BinderOptions>) |
Próbuje powiązać podane wystąpienie obiektu z wartościami konfiguracji, pasując nazwy właściwości do kluczy konfiguracji cyklicznie. |
Bind(IConfiguration, String, Object) |
Próbuje powiązać podane wystąpienie obiektu z sekcją konfiguracji określoną przez klucz przez dopasowywanie nazw właściwości względem kluczy konfiguracji cyklicznie. |
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 względem kluczy konfiguracji cyklicznie. |
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 względem kluczy konfiguracji cyklicznie. |
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 względem kluczy konfiguracji cyklicznie. |
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 względem kluczy konfiguracji cyklicznie. |
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 ramach elementu IConfiguration. |
AsEnumerable(IConfiguration, Boolean) |
Pobiera wyliczenie par klucz-wartość w obrębie IConfigurationelementu . |
GetConnectionString(IConfiguration, String) |
Pobiera wartość z określonym kluczem z |
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 pochodzi każda wartość. |
GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>) |
Generuje czytelny dla człowieka widok konfiguracji pokazujący, skąd pochodzi każda wartość. |
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 do użycia dla dostawców opartych na plikach. |
GetFileProvider(IConfigurationBuilder) |
Pobiera wartość domyślną IFileProvider do użycia dla dostawców opartych na plikach. |
SetBasePath(IConfigurationBuilder, String) |
Ustawia parametr FileProvider dla dostawców opartych na plikach na wartość PhysicalFileProvider przy użyciu ścieżki podstawowej. |
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>) |
Ustawia akcję domyślną, która ma być wywoływana dla dostawców opartych na plikach, gdy wystąpi błąd. |
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 |
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>) |
Dodaje źródło konfiguracji INI do |
AddIniFile(IConfigurationBuilder, String) |
Dodaje dostawcę konfiguracji INI pod adresem |
AddIniFile(IConfigurationBuilder, String, Boolean) |
Dodaje dostawcę konfiguracji INI pod adresem |
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean) |
Dodaje dostawcę konfiguracji INI pod adresem |
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 pod adresem |
AddJsonFile(IConfigurationBuilder, String, Boolean) |
Dodaje dostawcę konfiguracji JSON pod adresem |
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean) |
Dodaje dostawcę konfiguracji JSON pod adresem |
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.
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.
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.
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 elementu |
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>) |
Dodaje źródło konfiguracji XML do elementu |
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 elementu |
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla