ConfigurationManager Clase

Definición

Espacio de nombres:

Microsoft.Extensions.Configuration

Ensamblado:

Microsoft.Extensions.Configuration.dll

Paquete:

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

Source:

ConfigurationManager.cs

Representa un objeto de configuración mutable. Es un IConfigurationBuilder y un IConfigurationRoot. A medida que se agregan orígenes, actualiza su vista actual de la configuración. Una vez que se llama a IConfigurationBuilder.Build(), la configuración se inmoviliza.

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

Herencia

Object

ConfigurationManager

Implementaciones

IConfiguration IConfigurationBuilder IConfigurationManager IConfigurationRoot IDisposable

Comentarios

Es un IConfigurationBuilder y un IConfigurationRoot. A medida que se agregan orígenes, actualiza su vista actual de configuración. Una vez que se llama a IConfigurationBuilder.Build(), la configuración se inmoviliza.

Constructores

ConfigurationManager()

Crea un objeto de configuración mutable vacío que es un IConfigurationBuilder y un IConfigurationRoot.

Propiedades

Item[String]	Obtiene o establece un valor de configuración.
Sources	Obtiene los orígenes usados para obtener valores de configuración.

Métodos

Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación, liberación o restablecimiento de recursos no administrados.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetChildren()	Obtiene las subsecciones de configuración descendientes inmediatas.
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetSection(String)	Obtiene una subsección de configuración con la clave especificada.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

IConfiguration.GetReloadToken()	Devuelve un IChangeToken que se puede usar para observar cuándo se vuelve a cargar esta configuración.
IConfigurationBuilder.Add(IConfigurationSource)	Agrega un nuevo origen de configuración.
IConfigurationBuilder.Build()	Compila un IConfiguration con claves y valores del conjunto de orígenes registrados en Sources.
IConfigurationBuilder.Properties	Obtiene una colección de clave-valor que se puede usar para compartir datos entre el IConfigurationBuilder y los orígenes de configuración registrados.
IConfigurationRoot.Providers	Obtiene los proveedores de configuración de esta configuración.
IConfigurationRoot.Reload()	Fuerza a que los valores de configuración se vuelvan a cargar desde las instancias de IConfigurationProvider subyacentes.

Métodos de extensión

AddApplicationMetadata(IConfigurationBuilder, IHostEnvironment, String)	Registra un proveedor de configuración para los metadatos de la aplicación.
AddConfiguration(IConfigurationBuilder, IConfiguration)	Agrega una configuración existente a configurationBuilder.
AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean)	Agrega una configuración existente a configurationBuilder.
AddCommandLine(IConfigurationBuilder, Action<CommandLineConfigurationSource>)	Agrega un IConfigurationProvider que lee los valores de configuración de la línea de comandos.
AddCommandLine(IConfigurationBuilder, String[])	Agrega un CommandLineConfigurationProvider que lee los valores de configuración de la línea de comandos.
AddCommandLine(IConfigurationBuilder, String[], IDictionary<String,String>)	Agrega un CommandLineConfigurationProvider que lee los valores de configuración de la línea de comandos mediante las asignaciones de modificadores especificadas.
Bind(IConfiguration, Object)	Intenta enlazar la instancia de objeto dada a los valores de configuración mediante la coincidencia de nombres de propiedad con las claves de configuración de forma recursiva.
Bind(IConfiguration, Object, Action<BinderOptions>)	Intenta enlazar la instancia de objeto dada a los valores de configuración mediante la coincidencia de nombres de propiedad con las claves de configuración de forma recursiva.
Bind(IConfiguration, String, Object)	Intenta enlazar la instancia de objeto dada a la sección de configuración especificada por la clave mediante la coincidencia de nombres de propiedad con las claves de configuración de forma recursiva.
Get(IConfiguration, Type)	Intenta enlazar la instancia de configuración a una nueva instancia de tipo T. Si esta sección de configuración tiene un valor, se usará. De lo contrario, se enlazan los nombres de propiedad coincidentes con las claves de configuración de forma recursiva.
Get(IConfiguration, Type, Action<BinderOptions>)	Intenta enlazar la instancia de configuración a una nueva instancia de tipo T. Si esta sección de configuración tiene un valor, se usará. De lo contrario, se enlazan los nombres de propiedad coincidentes con las claves de configuración de forma recursiva.
Get<T>(IConfiguration)	Intenta enlazar la instancia de configuración a una nueva instancia de tipo T. Si esta sección de configuración tiene un valor, se usará. De lo contrario, se enlazan los nombres de propiedad coincidentes con las claves de configuración de forma recursiva.
Get<T>(IConfiguration, Action<BinderOptions>)	Intenta enlazar la instancia de configuración a una nueva instancia de tipo T. Si esta sección de configuración tiene un valor, se usará. De lo contrario, se enlazan los nombres de propiedad coincidentes con las claves de configuración de forma recursiva.
GetValue(IConfiguration, Type, String)	Extrae el valor con la clave especificada y lo convierte en el tipo especificado.
GetValue(IConfiguration, Type, String, Object)	Extrae el valor con la clave especificada y lo convierte en el tipo especificado.
GetValue<T>(IConfiguration, String)	Extrae el valor con la clave especificada y lo convierte en el tipo T.
GetValue<T>(IConfiguration, String, T)	Extrae el valor con la clave especificada y lo convierte en el tipo T.
Add<TSource>(IConfigurationBuilder, Action<TSource>)	Agrega un nuevo origen de configuración.
AsEnumerable(IConfiguration)	Obtenga la enumeración de pares clave-valor dentro de la IConfiguration.
AsEnumerable(IConfiguration, Boolean)	Obtiene la enumeración de pares clave-valor dentro de la IConfiguration.
GetConnectionString(IConfiguration, String)	Recupera el valor con la clave especificada de la sección ConnectionStrings del origen de configuración. Llamar a este método es abreviado para GetSection("ConnectionStrings")[name].
GetRequiredSection(IConfiguration, String)	Obtiene la subsección de configuración que tiene la clave especificada.
GetDebugView(IConfigurationRoot)	Genera una vista legible de la configuración que muestra de dónde procede cada valor.
GetDebugView(IConfigurationRoot, Func<ConfigurationDebugViewContext,String>)	Genera una vista legible de la configuración que muestra de dónde procede cada valor.
AddEnvironmentVariables(IConfigurationBuilder)	Agrega un IConfigurationProvider que lee los valores de configuración de las variables de entorno.
AddEnvironmentVariables(IConfigurationBuilder, Action<EnvironmentVariablesConfigurationSource>)	Agrega un IConfigurationProvider que lee los valores de configuración de las variables de entorno.
AddEnvironmentVariables(IConfigurationBuilder, String)	Agrega un IConfigurationProvider que lee los valores de configuración de las variables de entorno con un prefijo especificado.
GetFileLoadExceptionHandler(IConfigurationBuilder)	Obtiene el IFileProvider predeterminado que se va a usar para los proveedores basados en archivos.
GetFileProvider(IConfigurationBuilder)	Obtiene el IFileProvider predeterminado que se va a usar para los proveedores basados en archivos.
SetBasePath(IConfigurationBuilder, String)	Establece FileProvider para proveedores basados en archivos en physicalFileProvider con la ruta de acceso base.
SetFileLoadExceptionHandler(IConfigurationBuilder, Action<FileLoadExceptionContext>)	Establece una acción predeterminada que se va a invocar para los proveedores basados en archivos cuando se produce un error.
SetFileProvider(IConfigurationBuilder, IFileProvider)	Establece el IFileProvider predeterminado que se usará para los proveedores basados en archivos.
AddIniFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Agrega un origen de configuración INI a builder.
AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>)	Agrega un origen de configuración INI a builder.
AddIniFile(IConfigurationBuilder, String)	Agrega el proveedor de configuración INI en path a builder.
AddIniFile(IConfigurationBuilder, String, Boolean)	Agrega el proveedor de configuración INI en path a builder.
AddIniFile(IConfigurationBuilder, String, Boolean, Boolean)	Agrega el proveedor de configuración INI en path a builder.
AddIniStream(IConfigurationBuilder, Stream)	Agrega un origen de configuración INI a builder.
AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Agrega un origen de configuración JSON a builder.
AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>)	Agrega un origen de configuración JSON a builder.
AddJsonFile(IConfigurationBuilder, String)	Agrega el proveedor de configuración JSON en path a builder.
AddJsonFile(IConfigurationBuilder, String, Boolean)	Agrega el proveedor de configuración JSON en path a builder.
AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean)	Agrega el proveedor de configuración JSON en path a builder.
AddJsonStream(IConfigurationBuilder, Stream)	Agrega un origen de configuración JSON a builder.
AddKeyPerFile(IConfigurationBuilder, Action<KeyPerFileConfigurationSource>)	Agrega la configuración mediante archivos de un directorio. Los nombres de archivo se usan como clave, el contenido del archivo se usa como valor.
AddKeyPerFile(IConfigurationBuilder, String)	Agrega la configuración mediante archivos de un directorio. Los nombres de archivo se usan como clave, el contenido del archivo se usa como valor.
AddKeyPerFile(IConfigurationBuilder, String, Boolean)	Agrega la configuración mediante archivos de un directorio. Los nombres de archivo se usan como clave, el contenido del archivo se usa como valor.
AddKeyPerFile(IConfigurationBuilder, String, Boolean, Boolean)	Agrega la configuración mediante archivos de un directorio. Los nombres de archivo se usan como clave, el contenido del archivo se usa como valor.
AddInMemoryCollection(IConfigurationBuilder)	Agrega el proveedor de configuración de memoria a configurationBuilder.
AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>)	Agrega el proveedor de configuración de memoria a configurationBuilder.
AddUserSecrets(IConfigurationBuilder, Assembly)	Agrega el origen de configuración de secretos de usuario. Esto busca assembly en una instancia de UserSecretsIdAttribute, que especifica un identificador de secretos de usuario. Un identificador de secretos de usuario es un valor único que se usa para almacenar e identificar una colección de valores de configuración de secretos.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean)	Agrega el origen de configuración de secretos de usuario. Esto busca assembly en una instancia de UserSecretsIdAttribute, que especifica un identificador de secretos de usuario. Un identificador de secretos de usuario es un valor único que se usa para almacenar e identificar una colección de valores de configuración de secretos.
AddUserSecrets(IConfigurationBuilder, Assembly, Boolean, Boolean)	Agrega el origen de configuración de secretos de usuario. Esto busca assembly en una instancia de UserSecretsIdAttribute, que especifica un identificador de secretos de usuario. Un identificador de secretos de usuario es un valor único que se usa para almacenar e identificar una colección de valores de configuración de secretos.
AddUserSecrets(IConfigurationBuilder, String)	Agrega el origen de configuración de secretos de usuario con el identificador de secretos de usuario especificado. Un identificador de secretos de usuario es un valor único que se usa para almacenar e identificar una colección de valores de configuración de secretos.
AddUserSecrets(IConfigurationBuilder, String, Boolean)	Agrega el origen de configuración de secretos de usuario con el identificador de secretos de usuario especificado. Un identificador de secretos de usuario es un valor único que se usa para almacenar e identificar una colección de valores de configuración de secretos.
AddUserSecrets<T>(IConfigurationBuilder)	Agrega el origen de configuración de secretos de usuario. Busca en el ensamblado que contiene T de tipo para una instancia de UserSecretsIdAttribute, que especifica un identificador de secretos de usuario. Un identificador de secretos de usuario es un valor único que se usa para almacenar e identificar una colección de valores de configuración de secretos.
AddUserSecrets<T>(IConfigurationBuilder, Boolean)	Agrega el origen de configuración de secretos de usuario. Busca en el ensamblado que contiene T de tipo para una instancia de UserSecretsIdAttribute, que especifica un identificador de secretos de usuario. Un identificador de secretos de usuario es un valor único que se usa para almacenar e identificar una colección de valores de configuración de secretos.
AddUserSecrets<T>(IConfigurationBuilder, Boolean, Boolean)	Agrega el origen de configuración de secretos de usuario. Busca en el ensamblado que contiene T de tipo para una instancia de UserSecretsIdAttribute, que especifica un identificador de secretos de usuario. Un identificador de secretos de usuario es un valor único que se usa para almacenar e identificar una colección de valores de configuración de secretos.
AddXmlFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean)	Agrega un origen de configuración XML a builder.
AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>)	Agrega un origen de configuración XML a builder.
AddXmlFile(IConfigurationBuilder, String)	Agrega el proveedor de configuración XML en path a builder.
AddXmlFile(IConfigurationBuilder, String, Boolean)	Agrega el proveedor de configuración XML en path a builder.
AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean)	Agrega el proveedor de configuración XML en path a builder.
AddXmlStream(IConfigurationBuilder, Stream)	Agrega un origen de configuración XML a builder.