ConfigurationBuilder Klas

Definitie

Naamruimte:

Microsoft.Extensions.Configuration

Assembly:

Microsoft.Extensions.Configuration.dll

Pakket:

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

Bron:

ConfigurationBuilder.cs

Bouwt configuratie-instellingen op basis van sleutels/waarden voor gebruik in een toepassing.

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

Overname

Object

ConfigurationBuilder

Implementeringen

IConfigurationBuilder

Opmerkingen

Met behulp van deze klasse kunt u configuratiewaarden opslaan in een JSON-bestand, bijvoorbeeld en deze vervolgens ophalen tijdens runtime. Zie Configuratie - basisvoorbeeld voor meer informatie.

Als u een app migreert naar .NET Core 3.1 of een latere versie, kunt u deze klasse gebruiken om de bestandsfunctionaliteit app.config te vervangen die u mogelijk eerder hebt gebruikt om uw app te configureren.

Voorbeeld

In het volgende codefragment ziet u een vereenvoudigde app waarmee een ConfigurationBuilder object wordt gemaakt voor het ophalen van een tekenreekswaarde uit een JSON-bestand tijdens runtime.

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!
 */

De inhoud van het JSON-bestand wordt hier weergegeven.

{
  "weather": "stormy"
}

Constructors

Name	Description
ConfigurationBuilder()	Initialiseert een nieuw exemplaar van de ConfigurationBuilder klasse.

Eigenschappen

Name	Description
Properties	Hiermee haalt u een sleutel/waardeverzameling op die kan worden gebruikt voor het delen van gegevens tussen de IConfigurationBuilder en de geregistreerde IConfigurationProvider providers.
Sources	Hiermee haalt u de bronnen op die worden gebruikt om configuratiewaarden te verkrijgen.

Methoden

Name	Description
Add(IConfigurationSource)	Hiermee voegt u een nieuwe configuratiebron toe.
Build()	Bouwt een IConfiguration met sleutels en waarden van de set providers die zijn geregistreerd in Sources.

Extensiemethoden

Name	Description
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Hiermee voegt u een nieuwe configuratiebron toe.
AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Registreert een configuratieprovider voor toepassingsmetagegevens.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	IConfigurationProvider Hiermee worden configuratiewaarden van de opdrachtregel gelezen.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Hiermee voegt u een CommandLineConfigurationProviderIConfigurationProvider configuratiewaarden van de opdrachtregel toe met behulp van de opgegeven switchtoewijzingen.
AddCommandLine(IConfigurationBuilder, String[])	CommandLineConfigurationProvider IConfigurationProvider Hiermee worden configuratiewaarden van de opdrachtregel gelezen.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	Voegt een bestaande configuratie toe aan configurationBuilder.
AddConfiguration(IConfigurationBuilder, IConfiguration)	Voegt een bestaande configuratie toe aan configurationBuilder.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	IConfigurationProvider Hiermee worden configuratiewaarden uit omgevingsvariabelen gelezen.
AddEnvironmentVariables(IConfigurationBuilder, String)	Voegt een IConfigurationProvider waarde toe waarmee configuratiewaarden uit omgevingsvariabelen worden gelezen met een opgegeven voorvoegsel.
AddEnvironmentVariables(IConfigurationBuilder)	IConfigurationProvider Hiermee worden configuratiewaarden uit omgevingsvariabelen gelezen.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	Voegt een INI-configuratiebron toe aan builder.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Voegt een INI-configuratiebron toe aan builder.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	Voegt de INI-configuratieprovider toe path aan builder.
AddIniFile(IConfigurationBuilder, String, Boolean)	Voegt de INI-configuratieprovider toe path aan builder.
AddIniFile(IConfigurationBuilder, String)	Voegt de INI-configuratieprovider toe path aan builder.
AddIniStream(IConfigurationBuilder, Stream)	Voegt een INI-configuratiebron toe aan builder.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	Voegt de geheugenconfiguratieprovider toe aan configurationBuilder.
AddInMemoryCollection(IConfigurationBuilder)	Voegt de geheugenconfiguratieprovider toe aan configurationBuilder.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	Voegt een JSON-configuratiebron toe aan builder.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Voegt een JSON-configuratiebron toe aan builder.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	Voegt de JSON-configuratieprovider toe path aan builder.
AddJsonFile(IConfigurationBuilder, String, Boolean)	Voegt de JSON-configuratieprovider toe path aan builder.
AddJsonFile(IConfigurationBuilder, String)	Voegt de JSON-configuratieprovider toe path aan builder.
AddJsonStream(IConfigurationBuilder, Stream)	Voegt een JSON-configuratiebron toe aan builder.
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	Hiermee voegt u configuratie toe met behulp van bestanden uit een map. Bestandsnamen worden gebruikt als sleutel, bestandsinhoud wordt gebruikt als de waarde.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)	Hiermee voegt u configuratie toe met behulp van bestanden uit een map. Bestandsnamen worden gebruikt als sleutel, bestandsinhoud wordt gebruikt als de waarde.
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	Hiermee voegt u configuratie toe met behulp van bestanden uit een map. Bestandsnamen worden gebruikt als sleutel, bestandsinhoud wordt gebruikt als de waarde.
AddKeyPerFile(IConfigurationBuilder, String)	Hiermee voegt u configuratie toe met behulp van bestanden uit een map. Bestandsnamen worden gebruikt als sleutel, bestandsinhoud wordt gebruikt als de waarde.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Hiermee voegt u de configuratiebron voor gebruikersgeheimen toe. Hiermee wordt gezocht naar assembly een exemplaar van UserSecretsIdAttribute, waarmee een gebruikersgeheim-id wordt opgegeven. Een gebruikersgeheim-id is een unieke waarde die wordt gebruikt om een verzameling geheime configuratiewaarden op te slaan en te identificeren.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	Hiermee voegt u de configuratiebron voor gebruikersgeheimen toe. Hiermee wordt gezocht naar assembly een exemplaar van UserSecretsIdAttribute, waarmee een gebruikersgeheim-id wordt opgegeven. Een gebruikersgeheim-id is een unieke waarde die wordt gebruikt om een verzameling geheime configuratiewaarden op te slaan en te identificeren.
AddUserSecrets(IConfigurationBuilder, Assembly)	Hiermee voegt u de configuratiebron voor gebruikersgeheimen toe. Hiermee wordt gezocht naar assembly een exemplaar van UserSecretsIdAttribute, waarmee een gebruikersgeheim-id wordt opgegeven. Een gebruikersgeheim-id is een unieke waarde die wordt gebruikt om een verzameling geheime configuratiewaarden op te slaan en te identificeren.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	Hiermee voegt u de configuratiebron voor gebruikersgeheimen toe met de opgegeven gebruikersgeheimen-id. Een gebruikersgeheim-id is een unieke waarde die wordt gebruikt om een verzameling geheime configuratiewaarden op te slaan en te identificeren.
AddUserSecrets(IConfigurationBuilder, String)	Hiermee voegt u de configuratiebron voor gebruikersgeheimen toe met de opgegeven gebruikersgeheimen-id. Een gebruikersgeheim-id is een unieke waarde die wordt gebruikt om een verzameling geheime configuratiewaarden op te slaan en te identificeren.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	Hiermee voegt u de configuratiebron voor gebruikersgeheimen toe. Doorzoekt de assembly die het type T bevat voor een exemplaar van UserSecretsIdAttribute, waarmee een gebruikersgeheim-id wordt opgegeven. Een gebruikersgeheim-id is een unieke waarde die wordt gebruikt om een verzameling geheime configuratiewaarden op te slaan en te identificeren.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	Hiermee voegt u de configuratiebron voor gebruikersgeheimen toe. Doorzoekt de assembly die het type T bevat voor een exemplaar van UserSecretsIdAttribute, waarmee een gebruikersgeheim-id wordt opgegeven. Een gebruikersgeheim-id is een unieke waarde die wordt gebruikt om een verzameling geheime configuratiewaarden op te slaan en te identificeren.
AddUserSecrets<T>(IConfigurationBuilder)	Hiermee voegt u de configuratiebron voor gebruikersgeheimen toe. Doorzoekt de assembly die het type T bevat voor een exemplaar van UserSecretsIdAttribute, waarmee een gebruikersgeheim-id wordt opgegeven. Een gebruikersgeheim-id is een unieke waarde die wordt gebruikt om een verzameling geheime configuratiewaarden op te slaan en te identificeren.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	Voegt een XML-configuratiebron toe aan builder.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Voegt een XML-configuratiebron toe aan builder.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	Hiermee voegt u de XML-configuratieprovider path toe aan builder.
AddXmlFile(IConfigurationBuilder, String, Boolean)	Hiermee voegt u de XML-configuratieprovider path toe aan builder.
AddXmlFile(IConfigurationBuilder, String)	Hiermee voegt u de XML-configuratieprovider path toe aan builder.
AddXmlStream(IConfigurationBuilder, Stream)	Voegt een XML-configuratiebron toe aan builder.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Hiermee wordt een standaardactie opgehaald die moet worden aangeroepen voor providers op basis van bestanden wanneer er een fout optreedt.
GetFileProvider(IConfigurationBuilder)	Hiermee haalt u de standaardwaarde IFileProvider op die moet worden gebruikt voor providers op basis van bestanden.
SetBasePath(IConfigurationBuilder, String)	Hiermee stelt u de FileProvider voor op bestanden gebaseerde providers in op een PhysicalFileProvider met het basispad.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	Hiermee stelt u een standaardactie in die moet worden aangeroepen voor providers op basis van bestanden wanneer er een fout optreedt.
SetFileProvider(IConfigurationBuilder, IFileProvider)	Hiermee stelt u de standaardwaarde IFileProvider in die moet worden gebruikt voor op bestanden gebaseerde providers.

Zie ook

• Configuratie in .NET