ConfigurationManager Classe

Définition

Représente un objet de configuration mutable. Il s’agit à la fois d’un IConfigurationBuilder et d’un IConfigurationRoot. À mesure que des sources sont ajoutées, il met à jour sa vue actuelle de la configuration. Une fois IConfigurationBuilder.Build() appelée, la configuration est figée.

public ref class ConfigurationManager sealed : IDisposable, Microsoft::Extensions::Configuration::IConfigurationBuilder, Microsoft::Extensions::Configuration::IConfigurationRoot
public ref class ConfigurationManager sealed : IDisposable, Microsoft::Extensions::Configuration::IConfigurationManager, Microsoft::Extensions::Configuration::IConfigurationRoot
public sealed class ConfigurationManager : IDisposable, Microsoft.Extensions.Configuration.IConfigurationBuilder, Microsoft.Extensions.Configuration.IConfigurationRoot
public sealed class ConfigurationManager : IDisposable, Microsoft.Extensions.Configuration.IConfigurationManager, Microsoft.Extensions.Configuration.IConfigurationRoot
type ConfigurationManager = class
    interface IConfigurationBuilder
    interface IConfigurationRoot
    interface IConfiguration
    interface IDisposable
type ConfigurationManager = class
    interface IConfigurationManager
    interface IConfiguration
    interface IConfigurationBuilder
    interface IConfigurationRoot
    interface IDisposable
Public NotInheritable Class ConfigurationManager
Implements IConfigurationBuilder, IConfigurationRoot, IDisposable
Public NotInheritable Class ConfigurationManager
Implements IConfigurationManager, IConfigurationRoot, IDisposable
Héritage
ConfigurationManager
Implémente

Remarques

Il s’agit à la fois d’un IConfigurationBuilder et d’un IConfigurationRoot. À mesure que des sources sont ajoutées, il met à jour sa vue actuelle de la configuration.

Constructeurs

ConfigurationManager()

Crée un objet de configuration mutable vide qui est à la fois un IConfigurationBuilder et un IConfigurationRoot.

Propriétés

Item[String]

Obtient ou définit une valeur de configuration.

Sources

Obtient les sources utilisées pour obtenir les valeurs de configuration.

Méthodes

Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetChildren()

Obtient les sous-sections de configuration descendante immédiate.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetSection(String)

Obtient une sous-section de configuration avec la clé spécifiée.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

IConfiguration.GetReloadToken()

Retourne un IChangeToken qui peut être utilisé pour observer quand cette configuration est rechargée.

IConfigurationBuilder.Add(IConfigurationSource)

Ajoute une nouvelle source de configuration.

IConfigurationBuilder.Build()

Crée une IConfiguration avec des clés et des valeurs de l’ensemble de sources inscrites dans Sources.

IConfigurationBuilder.Properties

Obtient une collection clé-valeur qui peut être utilisée pour partager des données entre les sources de IConfigurationBuilder configuration inscrites et .

IConfigurationBuilder.Sources

Obtient les sources utilisées pour obtenir les valeurs de configuration.

IConfigurationRoot.Providers

Obtient les fournisseurs de configuration pour cette configuration.

IConfigurationRoot.Reload()

Force le rechargement des valeurs de configuration à partir des instances sous-jacentes IConfigurationProvider .

Méthodes d’extension

AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)

Inscrit un fournisseur de configuration pour les métadonnées d’application.

AddConfiguration(IConfigurationBuilder, IConfiguration)

Ajoute une configuration existante à configurationBuilder.

AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)

Ajoute une configuration existante à configurationBuilder.

AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)

Ajoute un IConfigurationProvider qui lit les valeurs de configuration à partir de la ligne de commande.

AddCommandLine(IConfigurationBuilder, String[])

Ajoute un CommandLineConfigurationProvider qui lit les valeurs de configuration à partir de la ligne de commande.

AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)

Ajoute un CommandLineConfigurationProvider qui lit les valeurs de configuration à partir de la ligne de commande en utilisant les mappages de commutateur spécifiés.

Bind(IConfiguration, Object)

Tente de lier l’instance d’objet donnée aux valeurs de configuration en faisant correspondre les noms de propriété avec les clés de configuration de manière récursive.

Bind(IConfiguration, Object, Action<BinderOptions>)

Tente de lier l’instance d’objet donnée aux valeurs de configuration en faisant correspondre les noms de propriété avec les clés de configuration de manière récursive.

Bind(IConfiguration, String, Object)

Tente de lier l’instance d’objet donnée à la section de configuration spécifiée par la clé en faisant correspondre les noms de propriété avec les clés de configuration de manière récursive.

Get(IConfiguration, Type)

Tente de lier l’instance de configuration à une nouvelle instance de type T. Si cette section de configuration a une valeur, celle-ci est utilisée. Sinon, la liaison est effectuée en faisant correspondre les noms de propriété aux clés de configuration de manière récursive.

Get(IConfiguration, Type, Action<BinderOptions>)

Tente de lier l’instance de configuration à une nouvelle instance de type T. Si cette section de configuration a une valeur, celle-ci est utilisée. Sinon, la liaison est effectuée en faisant correspondre les noms de propriété aux clés de configuration de manière récursive.

Get<T>(IConfiguration)

Tente de lier l’instance de configuration à une nouvelle instance de type T. Si cette section de configuration a une valeur, celle-ci est utilisée. Sinon, la liaison est effectuée en faisant correspondre les noms de propriété aux clés de configuration de manière récursive.

Get<T>(IConfiguration, Action<BinderOptions>)

Tente de lier l’instance de configuration à une nouvelle instance de type T. Si cette section de configuration a une valeur, celle-ci est utilisée. Sinon, la liaison est effectuée en faisant correspondre les noms de propriété aux clés de configuration de manière récursive.

GetValue(IConfiguration, Type, String)

Extrait la valeur avec la clé spécifiée et la convertit en type spécifié.

GetValue(IConfiguration, Type, String, Object)

Extrait la valeur avec la clé spécifiée et la convertit en type spécifié.

GetValue<T>(IConfiguration, String)

Extrait la valeur avec la clé spécifiée et la convertit en type T.

GetValue<T>(IConfiguration, String, T)

Extrait la valeur avec la clé spécifiée et la convertit en type T.

Add<TSource>(IConfigurationBuilder, Action<TSource>)

Ajoute une nouvelle source de configuration.

AddUserSecrets(IConfigurationBuilder)

Ajoute la source de configuration des secrets utilisateur. Recherche dans l’assembly de UserSecretsIdAttribute une instance de GetEntryAssembly().

AddUserSecrets(IConfigurationBuilder, Assembly)

Ajoute la source de configuration des secrets utilisateur.

AddUserSecrets(IConfigurationBuilder, String)

Ajoute la source de configuration des secrets utilisateur avec l’ID de secrets spécifié.

AddUserSecrets<T>(IConfigurationBuilder)

Ajoute la source de configuration des secrets utilisateur. Recherche dans l’assembly qui contient le type T, une instance de UserSecretsIdAttribute.

AsEnumerable(IConfiguration)

Obtenez l’énumération des paires clé-valeur dans le IConfiguration.

AsEnumerable(IConfiguration, Boolean)

Obtient l’énumération des paires clé-valeur dans le IConfiguration.

GetConnectionString(IConfiguration, String)

Récupère la valeur avec la clé spécifiée à partir de la ConnectionStrings section de la source de configuration. L’appel de cette méthode est abrégé pour GetSection("ConnectionStrings")[name].

GetRequiredSection(IConfiguration, String)

Obtient la sous-section de configuration qui a la clé spécifiée.

GetDebugView(IConfigurationRoot)

Génère une vue lisible par tous de la configuration qui montre d’où vient chaque valeur.

GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>)

Génère une vue lisible par tous de la configuration qui montre d’où vient chaque valeur.

AddEnvironmentVariables(IConfigurationBuilder)

Ajoute un IConfigurationProvider qui lit les valeurs de configuration à partir des variables d’environnement.

AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)

Ajoute un IConfigurationProvider qui lit les valeurs de configuration à partir des variables d’environnement.

AddEnvironmentVariables(IConfigurationBuilder, String)

Ajoute un IConfigurationProvider qui lit les valeurs de configuration à partir des variables d’environnement avec un préfixe spécifié.

GetFileLoadExceptionHandler(IConfigurationBuilder)

Obtient le IFileProvider par défaut à utiliser pour les fournisseurs basés sur des fichiers.

GetFileProvider(IConfigurationBuilder)

Obtient le IFileProvider par défaut à utiliser pour les fournisseurs basés sur des fichiers.

SetBasePath(IConfigurationBuilder, String)

Définit le FileProvider pour les fournisseurs basés sur des fichiers sur un PhysicalFileProvider avec le chemin de base.

SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)

Définit une action par défaut à appeler pour les fournisseurs basés sur des fichiers lorsqu’une erreur se produit.

SetFileProvider(IConfigurationBuilder, IFileProvider)

Définit le IFileProvider par défaut à utiliser pour les fournisseurs basés sur des fichiers.

AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)

Ajoute une source de configuration INI à builder.

AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)

Ajoute une source de configuration INI à builder.

AddIniFile(IConfigurationBuilder, String)

Ajoute le fournisseur de configuration INI au path vers builder.

AddIniFile(IConfigurationBuilder, String, Boolean)

Ajoute le fournisseur de configuration INI au path vers builder.

AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)

Ajoute le fournisseur de configuration INI au path vers builder.

AddIniStream(IConfigurationBuilder, Stream)

Ajoute une source de configuration INI à builder.

AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)

Ajoute une source de configuration JSON à builder.

AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)

Ajoute une source de configuration JSON à builder.

AddJsonFile(IConfigurationBuilder, String)

Ajoute le fournisseur de configuration JSON au path vers builder.

AddJsonFile(IConfigurationBuilder, String, Boolean)

Ajoute le fournisseur de configuration JSON au path vers builder.

AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)

Ajoute le fournisseur de configuration JSON au path vers builder.

AddJsonStream(IConfigurationBuilder, Stream)

Ajoute une source de configuration JSON à builder.

AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)

Ajoute une configuration en utilisant les fichiers d’un répertoire. Les noms de fichier sont utilisés comme clé, les contenus de fichier sont utilisés comme valeur.

AddKeyPerFile(IConfigurationBuilder, String)

Ajoute une configuration en utilisant les fichiers d’un répertoire. Les noms de fichier sont utilisés comme clé, les contenus de fichier sont utilisés comme valeur.

AddKeyPerFile(IConfigurationBuilder, String, Boolean)

Ajoute une configuration en utilisant les fichiers d’un répertoire. Les noms de fichier sont utilisés comme clé, les contenus de fichier sont utilisés comme valeur.

AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)

Ajoute une configuration en utilisant les fichiers d’un répertoire. Les noms de fichier sont utilisés comme clé, les contenus de fichier sont utilisés comme valeur.

AddInMemoryCollection(IConfigurationBuilder)

Ajoute le fournisseur de configuration de mémoire à configurationBuilder.

AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)

Ajoute le fournisseur de configuration de mémoire à configurationBuilder.

AddUserSecrets(IConfigurationBuilder, Assembly)

Ajoute la source de configuration des secrets utilisateur. Ceci recherche dans l’assembly une instance de UserSecretsIdAttribute qui spécifie un ID de secrets utilisateur.

Un ID de secrets utilisateur est une valeur unique utilisée pour stocker et identifier une collection de valeurs de configuration de secret.

AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)

Ajoute la source de configuration des secrets utilisateur. Ceci recherche dans l’assembly une instance de UserSecretsIdAttribute qui spécifie un ID de secrets utilisateur.

Un ID de secrets utilisateur est une valeur unique utilisée pour stocker et identifier une collection de valeurs de configuration de secret.

AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)

Ajoute la source de configuration des secrets utilisateur. Ceci recherche dans l’assembly une instance de UserSecretsIdAttribute qui spécifie un ID de secrets utilisateur.

Un ID de secrets utilisateur est une valeur unique utilisée pour stocker et identifier une collection de valeurs de configuration de secret.

AddUserSecrets(IConfigurationBuilder, String)

Ajoute la source de configuration des secrets utilisateur avec l’ID de secrets utilisateur spécifié.

Un ID de secrets utilisateur est une valeur unique utilisée pour stocker et identifier une collection de valeurs de configuration de secret.

AddUserSecrets(IConfigurationBuilder, String, Boolean)

Ajoute la source de configuration des secrets utilisateur avec l’ID de secrets utilisateur spécifié.

Un ID de secrets utilisateur est une valeur unique utilisée pour stocker et identifier une collection de valeurs de configuration de secret.

AddUserSecrets<T>(IConfigurationBuilder)

Ajoute la source de configuration des secrets utilisateur. Recherche dans l’assembly qui contient le T de type, une instance de UserSecretsIdAttribute qui spécifie un ID de secrets utilisateur.

Un ID de secrets utilisateur est une valeur unique utilisée pour stocker et identifier une collection de valeurs de configuration de secret.

AddUserSecrets<T>(IConfigurationBuilder, Boolean)

Ajoute la source de configuration des secrets utilisateur. Recherche dans l’assembly qui contient le T de type, une instance de UserSecretsIdAttribute qui spécifie un ID de secrets utilisateur.

Un ID de secrets utilisateur est une valeur unique utilisée pour stocker et identifier une collection de valeurs de configuration de secret.

AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)

Ajoute la source de configuration des secrets utilisateur. Recherche dans l’assembly qui contient le T de type, une instance de UserSecretsIdAttribute qui spécifie un ID de secrets utilisateur.

Un ID de secrets utilisateur est une valeur unique utilisée pour stocker et identifier une collection de valeurs de configuration de secret.

AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)

Ajoute une source de configuration XML à builder.

AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)

Ajoute une source de configuration XML à builder.

AddXmlFile(IConfigurationBuilder, String)

Ajoute le fournisseur de configuration XML au path vers builder.

AddXmlFile(IConfigurationBuilder, String, Boolean)

Ajoute le fournisseur de configuration XML au path vers builder.

AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)

Ajoute le fournisseur de configuration XML au path vers builder.

AddXmlStream(IConfigurationBuilder, Stream)

Ajoute une source de configuration XML à builder.

S’applique à