ConfigurationManager Klasse

Definition

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
ConfigurationManager
Implementiert

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: