ConfigurationManager Klasse
Definition
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änderliches Konfigurationsobjekt dar. Es ist sowohl ein als IConfigurationBuilder auch ein IConfigurationRoot. Wenn Quellen hinzugefügt werden, aktualisiert sie ihre aktuelle Ansicht der Konfiguration. Sobald IConfigurationBuilder.Build() der Aufruf erfolgt, wird die Konfiguration eingefroren.
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
-
ConfigurationManager
- Implementiert
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. |
AddAzureKeyVault(IConfigurationBuilder, AzureKeyVaultConfigurationOptions) |
Fügt einen IConfigurationProvider hinzu, der Konfigurationswerte aus Azure KeyVault liest. |
AddAzureKeyVault(IConfigurationBuilder, String) |
Fügt einen IConfigurationProvider hinzu, der Konfigurationswerte aus Azure KeyVault liest. |
AddAzureKeyVault(IConfigurationBuilder, String, KeyVaultClient, IKeyVaultSecretManager) |
Fügt einen IConfigurationProvider hinzu, der Konfigurationswerte aus Azure KeyVault liest. |
AddAzureKeyVault(IConfigurationBuilder, String, IKeyVaultSecretManager) |
Fügt einen IConfigurationProvider hinzu, der Konfigurationswerte aus Azure KeyVault liest. |
AddAzureKeyVault(IConfigurationBuilder, String, String, X509Certificate2) |
Fügt einen IConfigurationProvider hinzu, der Konfigurationswerte aus Azure KeyVault liest. |
AddAzureKeyVault(IConfigurationBuilder, String, String, X509Certificate2, IKeyVaultSecretManager) |
Fügt einen IConfigurationProvider hinzu, der Konfigurationswerte aus Azure KeyVault liest. |
AddAzureKeyVault(IConfigurationBuilder, String, String, String) |
Fügt einen IConfigurationProvider hinzu, der Konfigurationswerte aus Azure KeyVault liest. |
AddAzureKeyVault(IConfigurationBuilder, String, String, String, IKeyVaultSecretManager) |
Fügt einen IConfigurationProvider hinzu, der Konfigurationswerte aus Azure KeyVault liest. |
AddConfiguration(IConfigurationBuilder, IConfiguration) |
Fügt |
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean) |
Fügt |
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. |
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 für Benutzergeheimnisse mit der angegebenen Geheimnis-ID hinzu. |
AddUserSecrets<T>(IConfigurationBuilder) |
Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Durchsucht die Assembly, die den Typ |
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 |
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 |
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>) |
Fügt eine INI-Konfigurationsquelle zu |
AddIniFile(IConfigurationBuilder, String) |
Fügt den INI-Konfigurationsanbieter unter |
AddIniFile(IConfigurationBuilder, String, Boolean) |
Fügt den INI-Konfigurationsanbieter unter |
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean) |
Fügt den INI-Konfigurationsanbieter unter |
AddIniStream(IConfigurationBuilder, Stream) |
Fügt eine INI-Konfigurationsquelle zu |
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
Fügt |
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>) |
Fügt |
AddJsonFile(IConfigurationBuilder, String) |
Fügt |
AddJsonFile(IConfigurationBuilder, String, Boolean) |
Fügt |
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean) |
Fügt |
AddJsonStream(IConfigurationBuilder, Stream) |
Fügt |
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) |
Fügt Konfiguration mithilfe von Dateien aus einem Verzeichnis hinzu. Dateinamen werden als Schlüssel verwendet, Dateiinhalte als Wert. |
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) |
Fügt Konfiguration mithilfe von Dateien aus einem Verzeichnis hinzu. Dateinamen werden als Schlüssel verwendet, Dateiinhalte als Wert. |
AddInMemoryCollection(IConfigurationBuilder) |
Fügt den Speicherkonfigurationsanbieter |
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>) |
Fügt den Speicherkonfigurationsanbieter |
AddNewtonsoftJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
Fügt |
AddNewtonsoftJsonFile(IConfigurationBuilder, Action<NewtonsoftJsonConfigurationSource>) |
Fügt |
AddNewtonsoftJsonFile(IConfigurationBuilder, String) |
Fügt |
AddNewtonsoftJsonFile(IConfigurationBuilder, String, Boolean) |
Fügt |
AddNewtonsoftJsonFile(IConfigurationBuilder, String, Boolean, Boolean) |
Fügt |
AddNewtonsoftJsonStream(IConfigurationBuilder, Stream) |
Fügt |
AddUserSecrets(IConfigurationBuilder, Assembly) |
Fügt die Konfigurationsquelle der Benutzergeheimnisse hinzu. Dadurch wird 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 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 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 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 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 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 |
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>) |
Fügt |
AddXmlFile(IConfigurationBuilder, String) |
Fügt |
AddXmlFile(IConfigurationBuilder, String, Boolean) |
Fügt |
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean) |
Fügt |
AddXmlStream(IConfigurationBuilder, Stream) |
Fügt |
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für