ConfigurationManager Classe

Definição

Espaço de Nomes:: Microsoft.Extensions.Configuration

Assemblagem:: Microsoft.Extensions.Configuration.dll

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

Origem:: ConfigurationManager.cs

Origem:: ConfigurationManager.cs

Origem:: ConfigurationManager.cs

Origem:: ConfigurationManager.cs

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa um objeto de configuração mutável.

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

Herança: Object
ConfigurationManager

Implementações: IConfiguration IConfigurationBuilder IConfigurationManager IConfigurationRoot IDisposable

Observações

É tanto um IConfigurationBuilder como um IConfigurationRoot. À medida que as fontes são adicionadas, atualiza a sua visão atual da configuração.

Construtores

Name	Description
ConfigurationManager()	Cria um objeto de configuração vazio e mutável que é tanto um IConfigurationBuilder como IConfigurationRootum .

Propriedades

Name	Description
Item[String]	Recebe ou define um valor de configuração.
Sources	Obtém as fontes usadas para obter valores de configuração.

Métodos

Name	Description
Dispose()	Realiza tarefas definidas pela aplicação associadas à libertação, libertação ou reinício de recursos não geridos.
GetChildren()	Obtém as subsecções da configuração descendente imediata.
GetSection(String)	Recebe uma subsecção de configuração com a chave especificada.

Implementações de Interface Explícita

Name	Description
IConfiguration.GetReloadToken()	Retorna a IChangeToken que pode ser usado para observar quando esta configuração é recarregada.
IConfigurationBuilder.Add(IConfigurationSource)	Adiciona uma nova fonte de configuração.
IConfigurationBuilder.Build()	Constrói um IConfiguration com chaves e valores do conjunto de fontes registadas em Sources.
IConfigurationBuilder.Properties	Obtém uma coleção chave-valor que pode ser usada para partilhar dados entre as IConfigurationBuilder e as fontes de configuração registadas.
IConfigurationRoot.Providers	Obtém os fornecedores de configuração para esta configuração.
IConfigurationRoot.Reload()	Força os valores de configuração a serem recarregados a partir das instâncias subjacentes IConfigurationProvider .

Métodos da Extensão

Name	Description
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Adiciona uma nova fonte de configuração.
AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Regista um fornecedor de configuração para metadados da aplicação.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Adiciona um IConfigurationProvider que lê valores de configuração da linha de comandos.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Adiciona um CommandLineConfigurationProvider IConfigurationProvider que lê valores de configuração da linha de comandos usando os mapeamentos de switch especificados.
AddCommandLine(IConfigurationBuilder, String[])	Adiciona um CommandLineConfigurationProvider IConfigurationProvider que lê valores de configuração da linha de comandos.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	Adiciona uma configuração existente a `configurationBuilder`.
AddConfiguration(IConfigurationBuilder, IConfiguration)	Adiciona uma configuração existente a `configurationBuilder`.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Adiciona um IConfigurationProvider que lê valores de configuração de variáveis de ambiente.
AddEnvironmentVariables(IConfigurationBuilder, String)	Adiciona um IConfigurationProvider que lê valores de configuração de variáveis de ambiente com um prefixo especificado.
AddEnvironmentVariables(IConfigurationBuilder)	Adiciona um IConfigurationProvider que lê valores de configuração de variáveis de ambiente.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	Adiciona uma fonte de configuração INI a `builder`.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Adiciona uma fonte de configuração INI a `builder`.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	Adiciona o fornecedor de configuração INI em `path` a `builder`.
AddIniFile(IConfigurationBuilder, String, Boolean)	Adiciona o fornecedor de configuração INI em `path` a `builder`.
AddIniFile(IConfigurationBuilder, String)	Adiciona o fornecedor de configuração INI em `path` a `builder`.
AddIniStream(IConfigurationBuilder, Stream)	Adiciona uma fonte de configuração INI a `builder`.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	Adiciona o fornecedor de configuração de memória a `configurationBuilder`.
AddInMemoryCollection(IConfigurationBuilder)	Adiciona o fornecedor de configuração de memória a `configurationBuilder`.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	Adiciona uma fonte de configuração JSON a `builder`.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Adiciona uma fonte de configuração JSON a `builder`.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	Adiciona o fornecedor de configuração JSON em `path` a `builder`.
AddJsonFile(IConfigurationBuilder, String, Boolean)	Adiciona o fornecedor de configuração JSON em `path` a `builder`.
AddJsonFile(IConfigurationBuilder, String)	Adiciona o fornecedor de configuração JSON em `path` a `builder`.
AddJsonStream(IConfigurationBuilder, Stream)	Adiciona uma fonte de configuração JSON a `builder`.
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	Adiciona configuração usando ficheiros de um diretório. Os nomes dos ficheiros são usados como chave, o conteúdo dos ficheiros como valor.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)	Adiciona configuração usando ficheiros de um diretório. Os nomes dos ficheiros são usados como chave, o conteúdo dos ficheiros como valor.
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	Adiciona configuração usando ficheiros de um diretório. Os nomes dos ficheiros são usados como chave, o conteúdo dos ficheiros como valor.
AddKeyPerFile(IConfigurationBuilder, String)	Adiciona configuração usando ficheiros de um diretório. Os nomes dos ficheiros são usados como chave, o conteúdo dos ficheiros como valor.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Adiciona a fonte de configuração dos segredos do utilizador. Isto procura `assembly` uma instância de UserSecretsIdAttribute, que especifica um ID de segredos de utilizador. Um ID de segredos de utilizador é um valor único usado para armazenar e identificar uma coleção de valores de configuração secretos.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	Adiciona a fonte de configuração dos segredos do utilizador. Isto procura `assembly` uma instância de UserSecretsIdAttribute, que especifica um ID de segredos de utilizador. Um ID de segredos de utilizador é um valor único usado para armazenar e identificar uma coleção de valores de configuração secretos.
AddUserSecrets(IConfigurationBuilder, Assembly)	Adiciona a fonte de configuração dos segredos do utilizador. Isto procura `assembly` uma instância de UserSecretsIdAttribute, que especifica um ID de segredos de utilizador. Um ID de segredos de utilizador é um valor único usado para armazenar e identificar uma coleção de valores de configuração secretos.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	Adiciona a fonte de configuração dos secretos de utilizador com ID especificado de secretos de utilizador. Um ID de segredos de utilizador é um valor único usado para armazenar e identificar uma coleção de valores de configuração secretos.
AddUserSecrets(IConfigurationBuilder, String)	Adiciona a fonte de configuração dos secretos de utilizador com ID especificado de secretos de utilizador. Um ID de segredos de utilizador é um valor único usado para armazenar e identificar uma coleção de valores de configuração secretos.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	Adiciona a fonte de configuração dos segredos do utilizador. Pesquisa no assembly que contém o tipo `T` para uma instância de UserSecretsIdAttribute, que especifica um ID de segredos de utilizador. Um ID de segredos de utilizador é um valor único usado para armazenar e identificar uma coleção de valores de configuração secretos.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	Adiciona a fonte de configuração dos segredos do utilizador. Pesquisa no assembly que contém o tipo `T` para uma instância de UserSecretsIdAttribute, que especifica um ID de segredos de utilizador. Um ID de segredos de utilizador é um valor único usado para armazenar e identificar uma coleção de valores de configuração secretos.
AddUserSecrets<T>(IConfigurationBuilder)	Adiciona a fonte de configuração dos segredos do utilizador. Pesquisa no assembly que contém o tipo `T` para uma instância de UserSecretsIdAttribute, que especifica um ID de segredos de utilizador. Um ID de segredos de utilizador é um valor único usado para armazenar e identificar uma coleção de valores de configuração secretos.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	Adiciona uma fonte de configuração XML a `builder`.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Adiciona uma fonte de configuração XML a `builder`.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	Adiciona o fornecedor de configuração XML em `path` a `builder`.
AddXmlFile(IConfigurationBuilder, String, Boolean)	Adiciona o fornecedor de configuração XML em `path` a `builder`.
AddXmlFile(IConfigurationBuilder, String)	Adiciona o fornecedor de configuração XML em `path` a `builder`.
AddXmlStream(IConfigurationBuilder, Stream)	Adiciona uma fonte de configuração XML a `builder`.
AsEnumerable(IConfiguration, Boolean)	Obtenha a enumeração dos pares-chave-valor dentro do IConfiguration
AsEnumerable(IConfiguration)	Obtenha a enumeração dos pares-chave-valor dentro do IConfiguration
Bind(IConfiguration, Object, Action<BinderOptions>)	Tenta vincular a instância do objeto dada a valores de configuração, comparando nomes de propriedades com chaves de configuração de forma recursiva.
Bind(IConfiguration, Object)	Tenta vincular a instância do objeto dada a valores de configuração, comparando nomes de propriedades com chaves de configuração de forma recursiva.
Bind(IConfiguration, String, Object)	Tenta associar a instância de objeto dada à secção de configuração especificada pela chave, comparando os nomes das propriedades com chaves de configuração de forma recursiva.
Get(IConfiguration, Type, Action<BinderOptions>)	Tentativas de vincular a instância de configuração a uma nova instância do tipo T. Se esta secção de configuração tiver um valor, esse será usado. Caso contrário, vincula ao corresponder nomes de propriedades com chaves de configuração recursivamente.
Get(IConfiguration, Type)	Tentativas de vincular a instância de configuração a uma nova instância do tipo T. Se esta secção de configuração tiver um valor, esse será usado. Caso contrário, vincula ao corresponder nomes de propriedades com chaves de configuração recursivamente.
Get<T>(IConfiguration, Action<BinderOptions>)	Tentativas de vincular a instância de configuração a uma nova instância do tipo T. Se esta secção de configuração tiver um valor, esse será usado. Caso contrário, vincula ao corresponder nomes de propriedades com chaves de configuração recursivamente.
Get<T>(IConfiguration)	Tentativas de vincular a instância de configuração a uma nova instância do tipo T. Se esta secção de configuração tiver um valor, esse será usado. Caso contrário, vincula ao corresponder nomes de propriedades com chaves de configuração recursivamente.
GetConnectionString(IConfiguration, String)	Obtém a cadeia de ligação especificada da configuração especificada. Taquigrafia de `GetSection("ConnectionStrings")[name]`.
GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>)	Gera uma vista legível para humanos da configuração mostrando de onde veio cada valor.
GetDebugView(IConfigurationRoot)	Gera uma vista legível para humanos da configuração mostrando de onde veio cada valor.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Faz com que uma ação por defeito seja invocada para os fornecedores baseados em ficheiros quando ocorre um erro.
GetFileProvider(IConfigurationBuilder)	Obtém o padrão IFileProvider para ser usado em fornecedores baseados em ficheiros.
GetRequiredSection(IConfiguration, String)	Recebe uma subsecção de configuração com a chave especificada.
GetValue(IConfiguration, Type, String, Object)	Extrai o valor com a chave especificada e converte-o para o tipo especificado.
GetValue(IConfiguration, Type, String)	Extrai o valor com a chave especificada e converte-o para o tipo especificado.
GetValue<T>(IConfiguration, String, T)	Extrai o valor com a chave especificada e converte-o para o tipo T.
GetValue<T>(IConfiguration, String)	Extrai o valor com a chave especificada e converte-o para o tipo T.
SetBasePath(IConfigurationBuilder, String)	Define o FileProvider para fornecedores baseados em ficheiros para um PhysicalFileProvider com o caminho base.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	Define uma ação padrão a ser invocada para os fornecedores baseados em ficheiros quando ocorre um erro.
SetFileProvider(IConfigurationBuilder, IFileProvider)	Define o padrão IFileProvider para ser usado para fornecedores baseados em ficheiros.

Aplica-se a

Comentários

Esta página foi útil?