ConfigurationManager Klasse

Definition

Namespace:

Microsoft.Extensions.Configuration

Assembly:

Microsoft.Extensions.Configuration.dll

Paket:

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

Quelle:

ConfigurationManager.cs

Stellt ein veränderliches Konfigurationsobjekt dar. Es ist sowohl ein als IConfigurationBuilder auch ein IConfigurationRoot. Wenn Quellen hinzugefügt werden, wird die aktuelle Ansicht der Konfiguration aktualisiert. Sobald IConfigurationBuilder.Build() aufgerufen wird, wird die Konfiguration fixiert.

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

Vererbung

Object

ConfigurationManager

Implementiert

IConfiguration IConfigurationBuilder IConfigurationRoot IDisposable IConfigurationManager

Hinweise

Es ist sowohl ein als IConfigurationBuilder auch ein IConfigurationRoot. Wenn Quellen hinzugefügt werden, wird die aktuelle Ansicht der Konfiguration aktualisiert.

Konstruktoren

ConfigurationManager()

Erstellt ein leeres veränderliches Konfigurationsobjekt, das sowohl ein IConfigurationBuilder als auch ein IConfigurationRootist.

Eigenschaften

Item[String]	Ruft einen Konfigurationswert ab oder legt diesen fest.
Sources	Ruft die Quellen ab, die zum Abrufen von Konfigurationswerten verwendet werden.

Methoden

Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetChildren()	Ruft die unmittelbaren untergeordneten Konfigurationsunterabschnitte ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetSection(String)	Ruft einen Konfigurationsunterabschnitt mit dem angegebenen Schlüssel ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IConfiguration.GetReloadToken()	Gibt ein IChangeToken zurück, das verwendet werden kann, um zu beobachten, wann diese Konfiguration erneut geladen wird.
IConfigurationBuilder.Add(IConfigurationSource)	Fügt eine neue Konfigurationsquelle hinzu.
IConfigurationBuilder.Build()	Erstellt eine IConfiguration mit Schlüsseln und Werten aus Quellen, die in Sources registriert sind.
IConfigurationBuilder.Properties	Ruft eine Schlüssel-Wert-Auflistung ab, die zum Freigeben von Daten zwischen den IConfigurationBuilder registrierten Konfigurationsquellen und verwendet werden kann.
IConfigurationRoot.Providers	Ruft die Konfigurationsanbieter für diese Konfiguration ab.
IConfigurationRoot.Reload()	Erzwingt, dass die Konfigurationswerte aus den zugrunde liegenden IConfigurationProvider Instanzen neu geladen werden.

Erweiterungsmethoden

AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Registriert einen Konfigurationsanbieter für Anwendungsmetadaten.
AddConfiguration(IConfigurationBuilder, IConfiguration)	Fügt configurationBuilder eine vorhandene Konfiguration hinzu.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	Fügt configurationBuilder eine vorhandene Konfiguration hinzu.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Fügt eine IConfigurationProvider-Schnittstelle hinzu, die Konfigurationswerte aus der Befehlszeile liest.
AddCommandLine(IConfigurationBuilder, String[])	Fügt eine -Schnittstelle der CommandLineConfigurationProvider-Klasse hinzu, die Konfigurationswerte aus der Befehlszeile liest.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Fügt eine -Schnittstelle der CommandLineConfigurationProvider-Klasse hinzu, die mithilfe der angegebenen Optionszuordnungen Konfigurationswerte aus der Befehlszeile liest.
Bind(IConfiguration, Object)	Versucht, die angegebene Objektinstanz an Konfigurationswerte zu binden, indem Eigenschaftsnamen mit Konfigurationsschlüsseln rekursiv abgeglichen werden.
Bind(IConfiguration, Object, Action<BinderOptions>)	Versucht, die angegebene Objektinstanz an Konfigurationswerte zu binden, indem Eigenschaftsnamen mit Konfigurationsschlüsseln rekursiv abgeglichen werden.
Bind(IConfiguration, String, Object)	Versucht, die angegebene Objektinstanz an den durch den Schlüssel angegebenen Konfigurationsabschnitt zu binden, indem Eigenschaftsnamen mit Konfigurationsschlüsseln rekursiv abgeglichen werden.
Get(IConfiguration, Type)	Versucht, die Konfigurationsinstanz an eine neue Instanz vom Typ T zu binden. Wenn dieser Konfigurationsabschnitt einen Wert enthält, wird dieser verwendet. Andernfalls wird die Bindung durchgeführt, indem Eigenschaftsnamen mit Konfigurationsschlüsseln rekursiv abgeglichen werden.
Get(IConfiguration, Type, Action<BinderOptions>)	Versucht, die Konfigurationsinstanz an eine neue Instanz vom Typ T zu binden. Wenn dieser Konfigurationsabschnitt einen Wert enthält, wird dieser verwendet. Andernfalls wird die Bindung durchgeführt, indem Eigenschaftsnamen mit Konfigurationsschlüsseln rekursiv abgeglichen werden.
Get<T>(IConfiguration)	Versucht, die Konfigurationsinstanz an eine neue Instanz vom Typ T zu binden. Wenn dieser Konfigurationsabschnitt einen Wert enthält, wird dieser verwendet. Andernfalls wird die Bindung durchgeführt, indem Eigenschaftsnamen mit Konfigurationsschlüsseln rekursiv abgeglichen werden.
Get<T>(IConfiguration, Action<BinderOptions>)	Versucht, die Konfigurationsinstanz an eine neue Instanz vom Typ T zu binden. Wenn dieser Konfigurationsabschnitt einen Wert enthält, wird dieser verwendet. Andernfalls wird die Bindung durchgeführt, indem Eigenschaftsnamen mit Konfigurationsschlüsseln rekursiv abgeglichen werden.
GetValue(IConfiguration, Type, String)	Extrahiert den Wert mit dem angegebenen Schlüssel und konvertiert ihn in den angegebenen Typ.
GetValue(IConfiguration, Type, String, Object)	Extrahiert den Wert mit dem angegebenen Schlüssel und konvertiert ihn in den angegebenen Typ.
GetValue<T>(IConfiguration, String)	Extrahiert den Wert mit dem angegebenen Schlüssel und konvertiert ihn in Typ T.
GetValue<T>(IConfiguration, String, T)	Extrahiert den Wert mit dem angegebenen Schlüssel und konvertiert ihn in Typ T.
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Fügt eine neue Konfigurationsquelle hinzu.
AsEnumerable(IConfiguration)	Rufen Sie die Enumeration von Schlüssel-Wert-Paaren innerhalb der IConfigurationab.
AsEnumerable(IConfiguration, Boolean)	Ruft die Enumeration von Schlüssel-Wert-Paaren innerhalb von ab IConfiguration.
GetConnectionString(IConfiguration, String)	Ruft den Wert mit dem angegebenen Schlüssel aus dem ConnectionStrings Abschnitt der Konfigurationsquelle ab. Das Aufrufen dieser Methode ist die Kurzform für GetSection("ConnectionStrings")[name].
GetRequiredSection(IConfiguration, String)	Ruft den Konfigurationsunterabschnitt ab, der über den angegebenen Schlüssel verfügt.
GetDebugView(IConfigurationRoot)	Generiert eine lesbare Ansicht der Konfiguration, die anzeigt, woher die einzelnen Werte stammen.
GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>)	Generiert eine lesbare Ansicht der Konfiguration, die anzeigt, woher die einzelnen Werte stammen.
AddEnvironmentVariables(IConfigurationBuilder)	Fügt eine IConfigurationProvider-Schnittstelle hinzu, die Konfigurationswerte aus Umgebungsvariablen liest.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Fügt eine IConfigurationProvider-Schnittstelle hinzu, die Konfigurationswerte aus Umgebungsvariablen liest.
AddEnvironmentVariables(IConfigurationBuilder, String)	Fügt eine IConfigurationProvider-Schnittstelle hinzu, die Konfigurationswerte aus Umgebungsvariablen mit einem angegebenen Präfix liest.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Ruft die Standardschnittstelle IFileProvider ab, die für dateibasierte Anbieter verwendet werden soll.
GetFileProvider(IConfigurationBuilder)	Ruft die Standardschnittstelle IFileProvider ab, die für dateibasierte Anbieter verwendet werden soll.
SetBasePath(IConfigurationBuilder, String)	Legt die FileProvider-Klasse für dateibasierte Anbieter auf eine PhysicalFileProvider-Klasse mit dem Basispfad fest.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	Legt eine Standardaktion fest, die für dateibasierte Anbieter aufgerufen werden soll, wenn ein Fehler auftritt.
SetFileProvider(IConfigurationBuilder, IFileProvider)	Legt die Standardschnittstelle IFileProvider fest, die für dateibasierte Anbieter verwendet werden soll.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Fügt eine INI-Konfigurationsquelle zu builder hinzu.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	Fügt eine INI-Konfigurationsquelle zu builder hinzu.
AddIniFile(IConfigurationBuilder, String)	Fügt den INI-Konfigurationsanbieter unter path zu builder hinzu.
AddIniFile(IConfigurationBuilder, String, Boolean)	Fügt den INI-Konfigurationsanbieter unter path zu builder hinzu.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	Fügt den INI-Konfigurationsanbieter unter path zu builder hinzu.
AddIniStream(IConfigurationBuilder, Stream)	Fügt eine INI-Konfigurationsquelle zu builder hinzu.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Fügt builder eine JSON-Konfigurationsquelle hinzu.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	Fügt builder eine JSON-Konfigurationsquelle hinzu.
AddJsonFile(IConfigurationBuilder, String)	Fügt builder den JSON-Konfigurationsanbieter unter path hinzu.
AddJsonFile(IConfigurationBuilder, String, Boolean)	Fügt builder den JSON-Konfigurationsanbieter unter path hinzu.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	Fügt builder den JSON-Konfigurationsanbieter unter path hinzu.
AddJsonStream(IConfigurationBuilder, Stream)	Fügt builder eine JSON-Konfigurationsquelle hinzu.
AddInMemoryCollection(IConfigurationBuilder)	Fügt den Speicherkonfigurationsanbieter configurationBuilder hinzu.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	Fügt den Speicherkonfigurationsanbieter configurationBuilder hinzu.
AddUserSecrets(IConfigurationBuilder, Assembly)	Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Dadurch wird assembly nach einer Instanz von UserSecretsIdAttribute durchsucht, die eine Benutzergeheimnis-ID angibt. Eine Benutzergeheimnis-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung von Geheimniskonfigurationswerten verwendet wird.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Dadurch wird assembly nach einer Instanz von UserSecretsIdAttribute durchsucht, die eine Benutzergeheimnis-ID angibt. Eine Benutzergeheimnis-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung von Geheimniskonfigurationswerten verwendet wird.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Dadurch wird assembly nach einer Instanz von UserSecretsIdAttribute durchsucht, die eine Benutzergeheimnis-ID angibt. Eine Benutzergeheimnis-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung von Geheimniskonfigurationswerten verwendet wird.
AddUserSecrets(IConfigurationBuilder, String)	Fügt die Konfigurationsquelle von Benutzergeheimnissen mit angegebener Benutzergeheimnis-ID hinzu. Eine Benutzergeheimnis-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung von Geheimniskonfigurationswerten verwendet wird.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	Fügt die Konfigurationsquelle von Benutzergeheimnissen mit angegebener Benutzergeheimnis-ID hinzu. Eine Benutzergeheimnis-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung von Geheimniskonfigurationswerten verwendet wird.
AddUserSecrets<T>(IConfigurationBuilder)	Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Durchsucht die Assembly, die den Typ T für eine Instanz von UserSecretsIdAttribute enthält, die eine Benutzergeheimnis-ID angibt. Eine Benutzergeheimnis-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung von Geheimniskonfigurationswerten verwendet wird.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Durchsucht die Assembly, die den Typ T für eine Instanz von UserSecretsIdAttribute enthält, die eine Benutzergeheimnis-ID angibt. Eine Benutzergeheimnis-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung von Geheimniskonfigurationswerten verwendet wird.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Durchsucht die Assembly, die den Typ T für eine Instanz von UserSecretsIdAttribute enthält, die eine Benutzergeheimnis-ID angibt. Eine Benutzergeheimnis-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung von Geheimniskonfigurationswerten verwendet wird.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Fügt builder eine XML-Konfigurationsquelle hinzu.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	Fügt builder eine XML-Konfigurationsquelle hinzu.
AddXmlFile(IConfigurationBuilder, String)	Fügt builder den XML-Konfigurationsanbieter unter path hinzu.
AddXmlFile(IConfigurationBuilder, String, Boolean)	Fügt builder den XML-Konfigurationsanbieter unter path hinzu.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	Fügt builder den XML-Konfigurationsanbieter unter path hinzu.
AddXmlStream(IConfigurationBuilder, Stream)	Fügt builder eine XML-Konfigurationsquelle hinzu.