ConfigurationBuilder 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:

ConfigurationBuilder.cs

Usato per compilare le impostazioni di configurazione basate su chiave/valore da usare in un'applicazione.

public ref class ConfigurationBuilder : Microsoft::Extensions::Configuration::IConfigurationBuilder

public class ConfigurationBuilder : Microsoft.Extensions.Configuration.IConfigurationBuilder

type ConfigurationBuilder = class
    interface IConfigurationBuilder

Public Class ConfigurationBuilder
Implements IConfigurationBuilder

Ereditarietà

Object

ConfigurationBuilder

Implementazioni

IConfigurationBuilder

Commenti

Usando questa classe, è possibile archiviare i valori di configurazione in un file JSON, ad esempio, e quindi recuperarli in fase di esecuzione. Per altre informazioni, vedere Configuration - esempio di base.

Se si esegue la migrazione di un'app a .NET Core 3.1 o versione successiva, è possibile usare questa classe per sostituire la funzionalità del file app.config usata in precedenza per configurare l'app.

Esempio

Il frammento di codice seguente mostra un'app semplificata che crea un oggetto ConfigurationBuilder per recuperare un valore stringa da un file JSON in fase di esecuzione.

using Microsoft.Extensions.Configuration;

IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json", false, true);
IConfigurationRoot root = builder.Build();

Console.WriteLine($"Hello, { root["weather"] } world!");

/* This program outputs the following text:
 * 
 * Hello, stormy world!
 */

Il contenuto del file JSON è illustrato qui.

{
  "weather": "stormy"
}

Costruttori

ConfigurationBuilder()

Inizializza una nuova istanza della classe ConfigurationBuilder.

Proprietà

Properties	Ottiene una raccolta chiave/valore che può essere utilizzata per condividere i dati tra il IConfigurationBuilder e i provider di configurazione registrati.
Sources	Ottiene le origini utilizzate per ottenere i valori di configurazione.

Metodi

Add(IConfigurationSource)	Aggiunge una nuova origine di configurazione.
Build()	Compila un IConfiguration con chiavi e valori del set di provider registrati in Sources.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
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)

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.
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Aggiunge una nuova origine di configurazione.
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.

Vedi anche

• configurazione di in .NET