ConfigurationManager Klasse

Referenz

Definition

Namespace:: Microsoft.Extensions.Configuration

Assembly:: Microsoft.Extensions.Configuration.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein stummgeschaltetes Konfigurationsobjekt dar. Es ist sowohl ein als auch ein IConfigurationBuilder IConfigurationRoot. Da Quellen hinzugefügt werden, aktualisiert sie die aktuelle Ansicht der Konfiguration. Sobald IConfigurationBuilder.Build() die Konfiguration aufgerufen wird, wird die Konfiguration eingefroren.

public ref class ConfigurationManager sealed : IDisposable, Microsoft::Extensions::Configuration::IConfigurationBuilder, Microsoft::Extensions::Configuration::IConfigurationRoot

public sealed class ConfigurationManager : IDisposable, Microsoft.Extensions.Configuration.IConfigurationBuilder, Microsoft.Extensions.Configuration.IConfigurationRoot

type ConfigurationManager = class
    interface IConfigurationBuilder
    interface IConfigurationRoot
    interface IConfiguration
    interface IDisposable

Public NotInheritable Class ConfigurationManager
Implements IConfigurationBuilder, IConfigurationRoot, IDisposable

Vererbung: Object
ConfigurationManager

Implementiert: IConfiguration IConfigurationBuilder IConfigurationRoot IDisposable

Konstruktoren

ConfigurationManager()

Erstellt ein leeres stummgeschaltetes Konfigurationsobjekt, das sowohl IConfigurationBuilder ein als auch ein IConfigurationRoot.

Eigenschaften

Item[String]	Ruft einen Konfigurationswert ab oder legt diesen fest.
Sources

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 direkt absteigenden 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üsselwertsammlung ab, die zum Freigeben von Daten zwischen IConfigurationBuilder den registrierten Konfigurationsquellen verwendet werden kann.
IConfigurationBuilder.Sources	Ruft die Quellen ab, die zum Abrufen von Konfigurationswerten verwendet werden.
IConfigurationRoot.Providers	Ruft die Konfigurationsanbieter für diese Konfiguration ab.
IConfigurationRoot.Reload()	Erzwingt die Konfigurationswerte, die aus den zugrunde liegenden IConfigurationProvider Instanzen neu geladen werden sollen.

Erweiterungsmethoden

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 IConfigurationProvider-Schnittstelle der CommandLineConfigurationProvider-Klasse hinzu, die Konfigurationswerte aus der Befehlszeile liest.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Fügt eine IConfigurationProvider-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.
AddUserSecrets(IConfigurationBuilder)	Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Durchsucht die Assembly der GetEntryAssembly()-Methode nach einer Instanz der UserSecretsIdAttribute-Klasse.
AddUserSecrets(IConfigurationBuilder, Assembly)	Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu.
AddUserSecrets(IConfigurationBuilder, String)	Fügt die Konfigurationsquelle des Benutzerschlüssels mit der angegebenen Geheim-ID hinzu.
AddUserSecrets<T>(IConfigurationBuilder)	Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Durchsucht die Assembly, die den Typ `T` für eine Instanz der UserSecretsIdAttribute-Klasse enthält.
AsEnumerable(IConfiguration)	Rufen Sie die Aufzählung der Schlüsselwertpaare innerhalb des IConfigurationWerts ab.
AsEnumerable(IConfiguration, Boolean)	Ruft die Aufzählung der Schlüsselwertpaare innerhalb des IConfigurationWerts ab.
GetConnectionString(IConfiguration, String)	Ruft den Wert mit dem angegebenen Schlüssel aus dem `ConnectionStrings` Abschnitt der Konfigurationsquelle. Das Aufrufen dieser Methode ist Kurzhand für `GetSection("ConnectionStrings")[name]`.
GetRequiredSection(IConfiguration, String)	Ruft den Unterabschnitt der Konfiguration ab, der den angegebenen Schlüssel aufweist.
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.
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	Fügt Konfiguration mithilfe von Dateien aus einem Verzeichnis hinzu. Dateinamen werden als Schlüssel verwendet, Dateiinhalte als Wert.
AddKeyPerFile(IConfigurationBuilder, String)
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	Fügt Konfiguration mithilfe von Dateien aus einem Verzeichnis hinzu. Dateinamen werden als Schlüssel verwendet, Dateiinhalte als Wert.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)
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.

Gilt für: