ConfigurationManager Klasse

Definition

Namespace:: Microsoft.Extensions.Configuration

Assembly:: Microsoft.Extensions.Configuration.dll

Paket:: Microsoft.Extensions.Configuration v11.0.0-preview.4.26230.115

Quelle:: ConfigurationManager.cs

Quelle:: ConfigurationManager.cs

Quelle:: ConfigurationManager.cs

Quelle:: ConfigurationManager.cs

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 veränderbares Konfigurationsobjekt dar.

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 IConfigurationManager IConfigurationRoot IDisposable

Hinweise

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

Konstruktoren

Name	Beschreibung
ConfigurationManager()	Erstellt ein leeres, veränderbares Konfigurationsobjekt, das sowohl ein IConfigurationBuilder als auch ein IConfigurationRoot.

Eigenschaften

Name	Beschreibung
Item[String]	Dient zum Abrufen oder Festlegen eines Konfigurationswerts.
Sources	Ruft die Quellen ab, die zum Abrufen von Konfigurationswerten verwendet werden.

Methoden

Name	Beschreibung
Dispose()	Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind.
GetChildren()	Ruft die direkt untergeordneten Konfigurationsunterabschnitte ab.
GetSection(String)	Ruft einen Konfigurationsunterabschnitt mit dem angegebenen Schlüssel ab.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IConfiguration.GetReloadToken()	Gibt einen IChangeToken Wert zurück, der verwendet werden kann, um zu beobachten, wann diese Konfiguration neu geladen wird.
IConfigurationBuilder.Add(IConfigurationSource)	Fügt eine neue Konfigurationsquelle hinzu.
IConfigurationBuilder.Build()	Erstellt eine IConfiguration mit Schlüsseln und Werten aus der Gruppe von Quellen, die in Sourcesregistriert sind.
IConfigurationBuilder.Properties	Ruft eine Schlüsselwertauflistung ab, die zum Freigeben von Daten zwischen den IConfigurationBuilder registrierten Konfigurationsquellen 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

Name	Beschreibung
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Fügt eine neue Konfigurationsquelle hinzu.
AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Registriert einen Konfigurationsanbieter für Anwendungsmetadaten.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Fügt einen IConfigurationProvider Wert hinzu, der Konfigurationswerte aus der Befehlszeile liest.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Fügt einen CommandLineConfigurationProvider IConfigurationProvider Wert hinzu, der Konfigurationswerte aus der Befehlszeile mithilfe der angegebenen Switchzuordnungen liest.
AddCommandLine(IConfigurationBuilder, String[])	Fügt einen CommandLineConfigurationProvider IConfigurationProvider Wert hinzu, der Konfigurationswerte aus der Befehlszeile liest.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	Fügt eine vorhandene Konfiguration hinzu.`configurationBuilder`
AddConfiguration(IConfigurationBuilder, IConfiguration)	Fügt eine vorhandene Konfiguration hinzu.`configurationBuilder`
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Fügt einen IConfigurationProvider Wert hinzu, der Konfigurationswerte aus Umgebungsvariablen liest.
AddEnvironmentVariables(IConfigurationBuilder, String)	Fügt einen IConfigurationProvider Wert hinzu, der Konfigurationswerte aus Umgebungsvariablen mit einem angegebenen Präfix liest.
AddEnvironmentVariables(IConfigurationBuilder)	Fügt einen IConfigurationProvider Wert hinzu, der Konfigurationswerte aus Umgebungsvariablen liest.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	Fügt eine INI-Konfigurationsquelle zu `builder`.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Fügt eine INI-Konfigurationsquelle zu `builder`.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	Fügt den INI-Konfigurationsanbieter zu `pathbuilder`.
AddIniFile(IConfigurationBuilder, String, Boolean)	Fügt den INI-Konfigurationsanbieter zu `pathbuilder`.
AddIniFile(IConfigurationBuilder, String)	Fügt den INI-Konfigurationsanbieter zu `pathbuilder`.
AddIniStream(IConfigurationBuilder, Stream)	Fügt eine INI-Konfigurationsquelle zu `builder`.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	Fügt den Speicherkonfigurationsanbieter hinzu `configurationBuilder`.
AddInMemoryCollection(IConfigurationBuilder)	Fügt den Speicherkonfigurationsanbieter hinzu `configurationBuilder`.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	Fügt eine JSON-Konfigurationsquelle hinzu.`builder`
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Fügt eine JSON-Konfigurationsquelle hinzu.`builder`
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	Fügt den JSON-Konfigurationsanbieter zu `pathbuilder`.
AddJsonFile(IConfigurationBuilder, String, Boolean)	Fügt den JSON-Konfigurationsanbieter zu `pathbuilder`.
AddJsonFile(IConfigurationBuilder, String)	Fügt den JSON-Konfigurationsanbieter zu `pathbuilder`.
AddJsonStream(IConfigurationBuilder, Stream)	Fügt eine JSON-Konfigurationsquelle hinzu.`builder`
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	Fügt die Konfiguration mithilfe von Dateien aus einem Verzeichnis hinzu. Dateinamen werden als Schlüssel verwendet, Dateiinhalte werden als Wert verwendet.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)	Fügt die Konfiguration mithilfe von Dateien aus einem Verzeichnis hinzu. Dateinamen werden als Schlüssel verwendet, Dateiinhalte werden als Wert verwendet.
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	Fügt die Konfiguration mithilfe von Dateien aus einem Verzeichnis hinzu. Dateinamen werden als Schlüssel verwendet, Dateiinhalte werden als Wert verwendet.
AddKeyPerFile(IConfigurationBuilder, String)	Fügt die Konfiguration mithilfe von Dateien aus einem Verzeichnis hinzu. Dateinamen werden als Schlüssel verwendet, Dateiinhalte werden als Wert verwendet.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Fügt die Konfigurationsquelle für geheime Benutzerschlüssel hinzu. Dies sucht nach `assembly` einer Instanz von UserSecretsIdAttribute, die eine geheime Benutzer-ID angibt. Eine geheime Benutzer-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung geheimer Konfigurationswerte verwendet wird.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	Fügt die Konfigurationsquelle für geheime Benutzerschlüssel hinzu. Dies sucht nach `assembly` einer Instanz von UserSecretsIdAttribute, die eine geheime Benutzer-ID angibt. Eine geheime Benutzer-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung geheimer Konfigurationswerte verwendet wird.
AddUserSecrets(IConfigurationBuilder, Assembly)	Fügt die Konfigurationsquelle für geheime Benutzerschlüssel hinzu. Dies sucht nach `assembly` einer Instanz von UserSecretsIdAttribute, die eine geheime Benutzer-ID angibt. Eine geheime Benutzer-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung geheimer Konfigurationswerte verwendet wird.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	Fügt die Konfigurationsquelle für geheime Benutzerschlüssel mit der angegebenen ID für geheime Benutzerschlüssel hinzu. Eine geheime Benutzer-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung geheimer Konfigurationswerte verwendet wird.
AddUserSecrets(IConfigurationBuilder, String)	Fügt die Konfigurationsquelle für geheime Benutzerschlüssel mit der angegebenen ID für geheime Benutzerschlüssel hinzu. Eine geheime Benutzer-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung geheimer Konfigurationswerte verwendet wird.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	Fügt die Konfigurationsquelle für geheime Benutzerschlüssel hinzu. Durchsucht die Assembly, die den Typ `T` einer Instanz enthält UserSecretsIdAttribute, die eine geheime Benutzer-ID angibt. Eine geheime Benutzer-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung geheimer Konfigurationswerte verwendet wird.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	Fügt die Konfigurationsquelle für geheime Benutzerschlüssel hinzu. Durchsucht die Assembly, die den Typ `T` einer Instanz enthält UserSecretsIdAttribute, die eine geheime Benutzer-ID angibt. Eine geheime Benutzer-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung geheimer Konfigurationswerte verwendet wird.
AddUserSecrets<T>(IConfigurationBuilder)	Fügt die Konfigurationsquelle für geheime Benutzerschlüssel hinzu. Durchsucht die Assembly, die den Typ `T` einer Instanz enthält UserSecretsIdAttribute, die eine geheime Benutzer-ID angibt. Eine geheime Benutzer-ID ist ein eindeutiger Wert, der zum Speichern und Identifizieren einer Sammlung geheimer Konfigurationswerte verwendet wird.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	Fügt der XML-Konfigurationsquelle eine XML-Konfigurationsquelle hinzu `builder`.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Fügt der XML-Konfigurationsquelle eine XML-Konfigurationsquelle hinzu `builder`.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	Fügt den XML-Konfigurationsanbieter zu `pathbuilder`.
AddXmlFile(IConfigurationBuilder, String, Boolean)	Fügt den XML-Konfigurationsanbieter zu `pathbuilder`.
AddXmlFile(IConfigurationBuilder, String)	Fügt den XML-Konfigurationsanbieter zu `pathbuilder`.
AddXmlStream(IConfigurationBuilder, Stream)	Fügt der XML-Konfigurationsquelle eine XML-Konfigurationsquelle hinzu `builder`.
AsEnumerable(IConfiguration, Boolean)	Abrufen der Enumeration von Schlüsselwertpaaren innerhalb der IConfiguration
AsEnumerable(IConfiguration)	Abrufen der Enumeration von Schlüsselwertpaaren innerhalb der IConfiguration
Bind(IConfiguration, Object, Action<BinderOptions>)	Versucht, die angegebene Objektinstanz rekursiv an Konfigurationswerte zu binden, indem Eigenschaftennamen mit Konfigurationsschlüsseln übereinstimmen.
Bind(IConfiguration, Object)	Versucht, die angegebene Objektinstanz rekursiv an Konfigurationswerte zu binden, indem Eigenschaftennamen mit Konfigurationsschlüsseln übereinstimmen.
Bind(IConfiguration, String, Object)	Versucht, die angegebene Objektinstanz an den vom Schlüssel angegebenen Konfigurationsabschnitt zu binden, indem Eigenschaftennamen rekursiv mit Konfigurationsschlüsseln abgegleicht werden.
Get(IConfiguration, Type, Action<BinderOptions>)	Versucht, die Konfigurationsinstanz an eine neue Instanz vom Typ T zu binden. Wenn dieser Konfigurationsabschnitt einen Wert aufweist, wird dieser verwendet. Andernfalls wird die Bindung durch Zuordnen von Eigenschaftennamen mit Konfigurationsschlüsseln rekursiv festgelegt.
Get(IConfiguration, Type)	Versucht, die Konfigurationsinstanz an eine neue Instanz vom Typ T zu binden. Wenn dieser Konfigurationsabschnitt einen Wert aufweist, wird dieser verwendet. Andernfalls wird die Bindung durch Zuordnen von Eigenschaftennamen mit Konfigurationsschlüsseln rekursiv festgelegt.
Get<T>(IConfiguration, Action<BinderOptions>)	Versucht, die Konfigurationsinstanz an eine neue Instanz vom Typ T zu binden. Wenn dieser Konfigurationsabschnitt einen Wert aufweist, wird dieser verwendet. Andernfalls wird die Bindung durch Zuordnen von Eigenschaftennamen mit Konfigurationsschlüsseln rekursiv festgelegt.
Get<T>(IConfiguration)	Versucht, die Konfigurationsinstanz an eine neue Instanz vom Typ T zu binden. Wenn dieser Konfigurationsabschnitt einen Wert aufweist, wird dieser verwendet. Andernfalls wird die Bindung durch Zuordnen von Eigenschaftennamen mit Konfigurationsschlüsseln rekursiv festgelegt.
GetConnectionString(IConfiguration, String)	Ruft die angegebene Verbindungszeichenfolge aus der angegebenen Konfiguration ab. Kurzform für `GetSection("ConnectionStrings")[name]`.
GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>)	Generiert eine lesbare Ansicht der Konfiguration, die zeigt, woher jeder Wert stammt.
GetDebugView(IConfigurationRoot)	Generiert eine lesbare Ansicht der Konfiguration, die zeigt, woher jeder Wert stammt.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Ruft eine Standardaktion ab, die für dateibasierte Anbieter aufgerufen werden soll, wenn ein Fehler auftritt.
GetFileProvider(IConfigurationBuilder)	Ruft den Standardwert IFileProvider ab, der für dateibasierte Anbieter verwendet werden soll.
GetRequiredSection(IConfiguration, String)	Ruft einen Konfigurationsunterabschnitt mit dem angegebenen Schlüssel ab.
GetValue(IConfiguration, Type, String, Object)	Extrahiert den Wert mit dem angegebenen Schlüssel und konvertiert ihn in den angegebenen Typ.
GetValue(IConfiguration, Type, String)	Extrahiert den Wert mit dem angegebenen Schlüssel und konvertiert ihn in den angegebenen Typ.
GetValue<T>(IConfiguration, String, T)	Extrahiert den Wert mit dem angegebenen Schlüssel und konvertiert ihn in den Typ T.
GetValue<T>(IConfiguration, String)	Extrahiert den Wert mit dem angegebenen Schlüssel und konvertiert ihn in den Typ T.
SetBasePath(IConfigurationBuilder, String)	Legt den FileProvider für dateibasierte Anbieter auf einen PhysicalFileProvider mit dem Basispfad fest.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	Legt fest, dass eine Standardaktion für dateibasierte Anbieter aufgerufen wird, wenn ein Fehler auftritt.
SetFileProvider(IConfigurationBuilder, IFileProvider)	Legt den Standardwert IFileProvider fest, der für dateibasierte Anbieter verwendet werden soll.

Gilt für:

Feedback

War diese Seite hilfreich?