ConfigurationBuilder Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Extensions.Configuration

Assembly:: Microsoft.Extensions.Configuration.dll

Pacchetto:: Microsoft.Extensions.Configuration v8.0.0

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

Origine:: ConfigurationBuilder.cs

Origine:: ConfigurationBuilder.cs

Origine:: ConfigurationBuilder.cs

Origine:: ConfigurationBuilder.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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`.

Si applica a

Vedi anche

configurazione di in .NET

Condividi tramite