IConfigurationManager Schnittstelle
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änderbares Konfigurationsobjekt dar.
public interface class IConfigurationManager : Microsoft::Extensions::Configuration::IConfiguration, Microsoft::Extensions::Configuration::IConfigurationBuilder
public interface IConfigurationManager : Microsoft.Extensions.Configuration.IConfiguration, Microsoft.Extensions.Configuration.IConfigurationBuilder
type IConfigurationManager = interface
interface IConfiguration
interface IConfigurationBuilder
Public Interface IConfigurationManager
Implements IConfiguration, IConfigurationBuilder
- Abgeleitet
- Implementiert
Hinweise
Es ist sowohl ein IConfigurationBuilder als auch ein IConfiguration. Wenn Quellen hinzugefügt werden, aktualisiert sie die aktuelle Ansicht der Konfiguration.
Eigenschaften
| Name | Beschreibung |
|---|---|
| Item[String] |
Dient zum Abrufen oder Festlegen eines Konfigurationswerts. (Geerbt von IConfiguration) |
| Properties |
Ruft eine Schlüssel-/Wertauflistung ab, die zum Freigeben von Daten zwischen den IConfigurationBuilder registrierten und den registrierten IConfigurationSourceDaten verwendet werden kann. (Geerbt von IConfigurationBuilder) |
| Sources |
Ruft die Quellen ab, die zum Abrufen von Konfigurationswerten verwendet werden. (Geerbt von IConfigurationBuilder) |
Methoden
| Name | Beschreibung |
|---|---|
| Add(IConfigurationSource) |
Fügt eine neue Konfigurationsquelle hinzu. (Geerbt von IConfigurationBuilder) |
| Build() |
Erstellt eine IConfiguration mit Schlüsseln und Werten aus der Gruppe von Quellen, die in Sourcesregistriert sind. (Geerbt von IConfigurationBuilder) |
| GetChildren() |
Ruft die unmittelbar untergeordneten Konfigurationsunterabschnitte ab. (Geerbt von IConfiguration) |
| GetReloadToken() |
Gibt einen IChangeToken Wert zurück, der verwendet werden kann, um zu beobachten, wann diese Konfiguration neu geladen wird. (Geerbt von IConfiguration) |
| GetSection(String) |
Ruft einen Konfigurationsunterabschnitt mit dem angegebenen Schlüssel ab. (Geerbt von IConfiguration) |
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 CommandLineConfigurationProviderIConfigurationProvider Wert hinzu, der Konfigurationswerte aus der Befehlszeile mithilfe der angegebenen Switchzuordnungen liest. |
| AddCommandLine(IConfigurationBuilder, String[]) |
Fügt einen CommandLineConfigurationProviderIConfigurationProvider Wert hinzu, der Konfigurationswerte aus der Befehlszeile liest. |
| AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean) |
Fügt eine vorhandene Konfiguration hinzu. |
| AddConfiguration(IConfigurationBuilder, IConfiguration) |
Fügt eine vorhandene Konfiguration hinzu. |
| 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 |
| AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
Fügt eine INI-Konfigurationsquelle zu |
| AddIniFile(IConfigurationBuilder, String, Boolean, Boolean) |
Fügt den INI-Konfigurationsanbieter zu |
| AddIniFile(IConfigurationBuilder, String, Boolean) |
Fügt den INI-Konfigurationsanbieter zu |
| AddIniFile(IConfigurationBuilder, String) |
Fügt den INI-Konfigurationsanbieter zu |
| AddIniStream(IConfigurationBuilder, Stream) |
Fügt eine INI-Konfigurationsquelle zu |
| AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>) |
Fügt den Speicherkonfigurationsanbieter hinzu |
| AddInMemoryCollection(IConfigurationBuilder) |
Fügt den Speicherkonfigurationsanbieter hinzu |
| AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>) |
Fügt eine JSON-Konfigurationsquelle hinzu. |
| AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
Fügt eine JSON-Konfigurationsquelle hinzu. |
| AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean) |
Fügt den JSON-Konfigurationsanbieter zu |
| AddJsonFile(IConfigurationBuilder, String, Boolean) |
Fügt den JSON-Konfigurationsanbieter zu |
| AddJsonFile(IConfigurationBuilder, String) |
Fügt den JSON-Konfigurationsanbieter zu |
| AddJsonStream(IConfigurationBuilder, Stream) |
Fügt eine JSON-Konfigurationsquelle hinzu. |
| 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 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 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 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 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 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 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 |
| AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
Fügt der XML-Konfigurationsquelle eine XML-Konfigurationsquelle hinzu |
| AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean) |
Fügt den XML-Konfigurationsanbieter zu |
| AddXmlFile(IConfigurationBuilder, String, Boolean) |
Fügt den XML-Konfigurationsanbieter zu |
| AddXmlFile(IConfigurationBuilder, String) |
Fügt den XML-Konfigurationsanbieter zu |
| AddXmlStream(IConfigurationBuilder, Stream) |
Fügt der XML-Konfigurationsquelle eine XML-Konfigurationsquelle hinzu |
| 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 |
| 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. |