ConfigurationBuilder Classe

Definizione

Spazio dei nomi:: Microsoft.Extensions.Configuration

Assembly:: Microsoft.Extensions.Configuration.dll

Pacchetto:: Microsoft.Extensions.Configuration v11.0.0-preview.4.26230.115

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.

Compila 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 Configurazione - 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 precedentemente usata per configurare l'app.

Example

Il frammento di codice seguente mostra un'app semplificata che crea un ConfigurationBuilder oggetto 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

Nome	Descrizione
ConfigurationBuilder()	Inizializza una nuova istanza della classe ConfigurationBuilder.

Proprietà

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

Metodi

Nome	Descrizione
Add(IConfigurationSource)	Aggiunge una nuova origine di configurazione.
Build()	Compila un oggetto IConfiguration con chiavi e valori dal set di provider registrati in Sources.

Metodi di estensione

Nome	Descrizione
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Aggiunge una nuova origine di configurazione.
AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Registra un provider di configurazione per i metadati dell'applicazione.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Aggiunge un oggetto IConfigurationProvider che legge i valori di configurazione dalla riga di comando.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Aggiunge un oggetto CommandLineConfigurationProvider IConfigurationProvider che legge i valori di configurazione dalla riga di comando usando i mapping delle opzioni specificati.
AddCommandLine(IConfigurationBuilder, String[])	Aggiunge un oggetto CommandLineConfigurationProvider IConfigurationProvider che legge i valori di configurazione dalla riga di comando.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	Aggiunge una configurazione esistente a `configurationBuilder`.
AddConfiguration(IConfigurationBuilder, IConfiguration)	Aggiunge una configurazione esistente a `configurationBuilder`.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Aggiunge un oggetto IConfigurationProvider che legge i valori di configurazione dalle variabili di ambiente.
AddEnvironmentVariables(IConfigurationBuilder, String)	Aggiunge un oggetto IConfigurationProvider che legge i valori di configurazione dalle variabili di ambiente con un prefisso specificato.
AddEnvironmentVariables(IConfigurationBuilder)	Aggiunge un oggetto IConfigurationProvider che legge i valori di configurazione dalle variabili di ambiente.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	Aggiunge un'origine di configurazione INI a `builder`.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Aggiunge un'origine di configurazione INI a `builder`.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	Aggiunge il provider di configurazione INI all'indirizzo `pathbuilder`.
AddIniFile(IConfigurationBuilder, String, Boolean)	Aggiunge il provider di configurazione INI all'indirizzo `pathbuilder`.
AddIniFile(IConfigurationBuilder, String)	Aggiunge il provider di configurazione INI all'indirizzo `pathbuilder`.
AddIniStream(IConfigurationBuilder, Stream)	Aggiunge un'origine di configurazione INI a `builder`.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	Aggiunge il provider di configurazione della memoria a `configurationBuilder`.
AddInMemoryCollection(IConfigurationBuilder)	Aggiunge il provider di configurazione della memoria a `configurationBuilder`.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	Aggiunge un'origine di configurazione JSON a `builder`.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Aggiunge un'origine di configurazione JSON a `builder`.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	Aggiunge il provider di configurazione JSON all'indirizzo `pathbuilder`.
AddJsonFile(IConfigurationBuilder, String, Boolean)	Aggiunge il provider di configurazione JSON all'indirizzo `pathbuilder`.
AddJsonFile(IConfigurationBuilder, String)	Aggiunge il provider di configurazione JSON all'indirizzo `pathbuilder`.
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, 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.
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)	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.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Aggiunge l'origine di configurazione dei segreti utente. Viene eseguita la ricerca `assembly` di 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. Viene eseguita la ricerca `assembly` di 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)	Aggiunge l'origine di configurazione dei segreti utente. Viene eseguita la ricerca `assembly` di 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, 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(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<T>(IConfigurationBuilder, Boolean, Boolean)	Aggiunge l'origine di configurazione dei segreti utente. Cerca nell'assembly che contiene un'istanza `T` 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 un'istanza `T` 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)	Aggiunge l'origine di configurazione dei segreti utente. Cerca nell'assembly che contiene un'istanza `T` 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, Action<XmlConfigurationSource>)	Aggiunge un'origine di configurazione XML a `builder`.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Aggiunge un'origine di configurazione XML a `builder`.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	Aggiunge il provider di configurazione XML all'indirizzo `pathbuilder`.
AddXmlFile(IConfigurationBuilder, String, Boolean)	Aggiunge il provider di configurazione XML all'indirizzo `pathbuilder`.
AddXmlFile(IConfigurationBuilder, String)	Aggiunge il provider di configurazione XML all'indirizzo `pathbuilder`.
AddXmlStream(IConfigurationBuilder, Stream)	Aggiunge un'origine di configurazione XML a `builder`.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Ottiene un'azione predefinita da richiamare per i provider basati su file quando si verifica un errore.
GetFileProvider(IConfigurationBuilder)	Ottiene l'impostazione predefinita IFileProvider 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 l'impostazione predefinita IFileProvider da utilizzare per i provider basati su file.

Si applica a

Vedi anche

Configurazione in .NET

Commenti e suggerimenti

Questa pagina è stata utile?