ConfigurationManager Classe

Definizione

Spazio dei nomi:

Microsoft.Extensions.Configuration

Assembly:

Microsoft.Extensions.Configuration.dll

Pacchetto:

Microsoft.Extensions.Configuration v9.0.0-preview.7.24405.7

Origine:

ConfigurationManager.cs

Rappresenta un oggetto di configurazione modificabile. È sia un IConfigurationBuilder che un IConfigurationRoot. Man mano che vengono aggiunte le origini, aggiorna la visualizzazione corrente della configurazione. Dopo aver chiamato IConfigurationBuilder.Build(), la configurazione viene bloccata.

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

Ereditarietà

Object

ConfigurationManager

Implementazioni

IConfiguration IConfigurationBuilder IConfigurationManager IConfigurationRoot IDisposable

Commenti

È sia un IConfigurationBuilder che un IConfigurationRoot. Man mano che vengono aggiunte le origini, aggiorna la visualizzazione corrente della configurazione. Dopo aver chiamato IConfigurationBuilder.Build(), la configurazione viene bloccata.

Costruttori

ConfigurationManager()

Crea un oggetto di configurazione modificabile vuoto che sia un IConfigurationBuilder che un IConfigurationRoot.

Proprietà

Item[String]	Ottiene o imposta un valore di configurazione.
Sources	Ottiene le origini utilizzate per ottenere i valori di configurazione.

Metodi

Dispose()	Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetChildren()	Ottiene le sottosezioni di configurazione discendenti immediate.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetSection(String)	Ottiene una sottosezione di configurazione con la chiave specificata.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IConfiguration.GetReloadToken()	Restituisce un IChangeToken che può essere utilizzato per osservare quando questa configurazione viene ricaricata.
IConfigurationBuilder.Add(IConfigurationSource)	Aggiunge una nuova origine di configurazione.
IConfigurationBuilder.Build()	Compila un IConfiguration con chiavi e valori del set di origini registrate in Sources.
IConfigurationBuilder.Properties	Ottiene una raccolta chiave-valore che può essere utilizzata per condividere i dati tra il IConfigurationBuilder e le origini di configurazione registrate.
IConfigurationRoot.Providers	Ottiene i provider di configurazione per questa configurazione.
IConfigurationRoot.Reload()	Forza il ricaricare i valori di configurazione dalle istanze di IConfigurationProvider sottostanti.

Metodi di estensione

AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Registra un provider di configurazione per i metadati dell'applicazione.
AddConfiguration(IConfigurationBuilder, IConfiguration)	Aggiunge una configurazione esistente a configurationBuilder.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	Aggiunge una configurazione esistente a configurationBuilder.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Aggiunge un IConfigurationProvider che legge i valori di configurazione dalla riga di comando.
AddCommandLine(IConfigurationBuilder, String[])	Aggiunge un CommandLineConfigurationProvider che legge i valori di configurazione dalla riga di comando.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Aggiunge un CommandLineConfigurationProvider che legge i valori di configurazione dalla riga di comando usando i mapping delle opzioni specificati.
Bind(IConfiguration, Object)	Tenta di associare l'istanza dell'oggetto specificata ai valori di configurazione associando i nomi delle proprietà alle chiavi di configurazione in modo ricorsivo.
Bind(IConfiguration, Object, Action<BinderOptions>)	Tenta di associare l'istanza dell'oggetto specificata ai valori di configurazione associando i nomi delle proprietà alle chiavi di configurazione in modo ricorsivo.
Bind(IConfiguration, String, Object)	Tenta di associare l'istanza dell'oggetto specificata alla sezione di configurazione specificata dalla chiave associando i nomi delle proprietà alle chiavi di configurazione in modo ricorsivo.
Get(IConfiguration, Type)	Tenta di associare l'istanza di configurazione a una nuova istanza di tipo T. Se questa sezione di configurazione ha un valore, verrà usato . In caso contrario, associare i nomi delle proprietà alle chiavi di configurazione in modo ricorsivo.
Get(IConfiguration, Type, Action<BinderOptions>)	Tenta di associare l'istanza di configurazione a una nuova istanza di tipo T. Se questa sezione di configurazione ha un valore, verrà usato . In caso contrario, associare i nomi delle proprietà alle chiavi di configurazione in modo ricorsivo.
Get<T>(IConfiguration)	Tenta di associare l'istanza di configurazione a una nuova istanza di tipo T. Se questa sezione di configurazione ha un valore, verrà usato . In caso contrario, associare i nomi delle proprietà alle chiavi di configurazione in modo ricorsivo.
Get<T>(IConfiguration, Action<BinderOptions>)	Tenta di associare l'istanza di configurazione a una nuova istanza di tipo T. Se questa sezione di configurazione ha un valore, verrà usato . In caso contrario, associare i nomi delle proprietà alle chiavi di configurazione in modo ricorsivo.
GetValue(IConfiguration, Type, String)	Estrae il valore con la chiave specificata e lo converte nel tipo specificato.
GetValue(IConfiguration, Type, String, Object)	Estrae il valore con la chiave specificata e lo converte nel tipo specificato.
GetValue<T>(IConfiguration, String)	Estrae il valore con la chiave specificata e lo converte nel tipo T.
GetValue<T>(IConfiguration, String, T)	Estrae il valore con la chiave specificata e lo converte nel tipo T.
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Aggiunge una nuova origine di configurazione.
AsEnumerable(IConfiguration)	Ottenere l'enumerazione delle coppie chiave-valore all'interno del IConfiguration.
AsEnumerable(IConfiguration, Boolean)	Ottiene l'enumerazione delle coppie chiave-valore all'interno del IConfiguration.
GetConnectionString(IConfiguration, String)	Recupera il valore con la chiave specificata dalla sezione ConnectionStrings dell'origine di configurazione. La chiamata a questo metodo è abbreviata per GetSection("ConnectionStrings")[name].
GetRequiredSection(IConfiguration, String)	Ottiene la sottosezione di configurazione con la chiave specificata.
GetDebugView(IConfigurationRoot)	Genera una visualizzazione leggibile della configurazione che mostra la provenienza di ogni valore.
GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>)	Genera una visualizzazione leggibile della configurazione che mostra la provenienza di ogni valore.
AddEnvironmentVariables(IConfigurationBuilder)	Aggiunge un IConfigurationProvider che legge i valori di configurazione dalle variabili di ambiente.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Aggiunge un IConfigurationProvider che legge i valori di configurazione dalle variabili di ambiente.
AddEnvironmentVariables(IConfigurationBuilder, String)	Aggiunge un IConfigurationProvider che legge i valori di configurazione dalle variabili di ambiente con un prefisso specificato.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Ottiene il IFileProvider predefinito da utilizzare per i provider basati su file.
GetFileProvider(IConfigurationBuilder)	Ottiene il IFileProvider predefinito da utilizzare per i provider basati su file.
SetBasePath(IConfigurationBuilder, String)	Imposta FileProvider per i provider basati su file su un PhysicalFileProvider con il percorso di base.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	Imposta un'azione predefinita da richiamare per i provider basati su file quando si verifica un errore.
SetFileProvider(IConfigurationBuilder, IFileProvider)	Imposta il IFileProvider predefinito da utilizzare per i provider basati su file.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Aggiunge un'origine di configurazione INI a builder.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	Aggiunge un'origine di configurazione INI a builder.
AddIniFile(IConfigurationBuilder, String)	Aggiunge il provider di configurazione INI in path a builder.
AddIniFile(IConfigurationBuilder, String, Boolean)	Aggiunge il provider di configurazione INI in path a builder.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	Aggiunge il provider di configurazione INI in path a builder.
AddIniStream(IConfigurationBuilder, Stream)	Aggiunge un'origine di configurazione INI a builder.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Aggiunge un'origine di configurazione JSON a builder.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	Aggiunge un'origine di configurazione JSON a builder.
AddJsonFile(IConfigurationBuilder, String)	Aggiunge il provider di configurazione JSON in path a builder.
AddJsonFile(IConfigurationBuilder, String, Boolean)	Aggiunge il provider di configurazione JSON in path a builder.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	Aggiunge il provider di configurazione JSON in path a builder.
AddJsonStream(IConfigurationBuilder, Stream)	Aggiunge un'origine di configurazione JSON a builder.
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	Aggiunge la configurazione usando i file da una directory. I nomi di file vengono usati come chiave, il contenuto del file viene usato come valore.
AddKeyPerFile(IConfigurationBuilder, String)	Aggiunge la configurazione usando i file da una directory. I nomi di file vengono usati come chiave, il contenuto del file viene usato come valore.
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	Aggiunge la configurazione usando i file da una directory. I nomi di file vengono usati come chiave, il contenuto del file viene usato come valore.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)	Aggiunge la configurazione usando i file da una directory. I nomi di file vengono usati come chiave, il contenuto del file viene usato come valore.
AddInMemoryCollection(IConfigurationBuilder)	Aggiunge il provider di configurazione della memoria a configurationBuilder.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	Aggiunge il provider di configurazione della memoria a configurationBuilder.
AddUserSecrets(IConfigurationBuilder, Assembly)	Aggiunge l'origine di configurazione dei segreti utente. In questo modo assembly cerca un'istanza di UserSecretsIdAttribute, che specifica un ID segreto utente. Un ID segreto utente è un valore univoco usato per archiviare e identificare una raccolta di valori di configurazione dei segreti.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	Aggiunge l'origine di configurazione dei segreti utente. In questo modo assembly cerca un'istanza di UserSecretsIdAttribute, che specifica un ID segreto utente. Un ID segreto utente è un valore univoco usato per archiviare e identificare una raccolta di valori di configurazione dei segreti.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Aggiunge l'origine di configurazione dei segreti utente. In questo modo assembly cerca un'istanza di UserSecretsIdAttribute, che specifica un ID segreto utente. Un ID segreto utente è un valore univoco usato per archiviare e identificare una raccolta di valori di configurazione dei segreti.
AddUserSecrets(IConfigurationBuilder, String)	Aggiunge l'origine di configurazione dei segreti utente con l'ID dei segreti utente specificato. Un ID segreto utente è un valore univoco usato per archiviare e identificare una raccolta di valori di configurazione dei segreti.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	Aggiunge l'origine di configurazione dei segreti utente con l'ID dei segreti utente specificato. Un ID segreto utente è un valore univoco usato per archiviare e identificare una raccolta di valori di configurazione dei segreti.
AddUserSecrets<T>(IConfigurationBuilder)	Aggiunge l'origine di configurazione dei segreti utente. Cerca nell'assembly che contiene il tipo T per un'istanza di UserSecretsIdAttribute, che specifica un ID segreto utente. Un ID segreto utente è un valore univoco usato per archiviare e identificare una raccolta di valori di configurazione dei segreti.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	Aggiunge l'origine di configurazione dei segreti utente. Cerca nell'assembly che contiene il tipo T per un'istanza di UserSecretsIdAttribute, che specifica un ID segreto utente. Un ID segreto utente è un valore univoco usato per archiviare e identificare una raccolta di valori di configurazione dei segreti.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	Aggiunge l'origine di configurazione dei segreti utente. Cerca nell'assembly che contiene il tipo T per un'istanza di UserSecretsIdAttribute, che specifica un ID segreto utente. Un ID segreto utente è un valore univoco usato per archiviare e identificare una raccolta di valori di configurazione dei segreti.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Aggiunge un'origine di configurazione XML a builder.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	Aggiunge un'origine di configurazione XML a builder.
AddXmlFile(IConfigurationBuilder, String)	Aggiunge il provider di configurazione XML in path a builder.
AddXmlFile(IConfigurationBuilder, String, Boolean)	Aggiunge il provider di configurazione XML in path a builder.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	Aggiunge il provider di configurazione XML in path a builder.
AddXmlStream(IConfigurationBuilder, Stream)	Aggiunge un'origine di configurazione XML a builder.