ConfigurationBuilder Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se usa para crear opciones de configuración basadas en clave y valor para su uso en una aplicación.
public ref class ConfigurationBuilder : Microsoft::Extensions::Configuration::IConfigurationBuilderpublic class ConfigurationBuilder : Microsoft.Extensions.Configuration.IConfigurationBuildertype ConfigurationBuilder = class
interface IConfigurationBuilderPublic Class ConfigurationBuilder
Implements IConfigurationBuilder- Herencia
-
ConfigurationBuilder
- Implementaciones
Comentarios
Con esta clase, puede almacenar valores de configuración en un archivo JSON, por ejemplo, y luego recuperarlos en tiempo de ejecución. Para obtener más información, vea configuración de : ejemplo básico.
Si va a migrar una aplicación a .NET Core 3.1 o una versión posterior, puede usar esta clase para reemplazar la funcionalidad de archivo de app.config que puede haber usado anteriormente para configurar la aplicación.
Ejemplo
El fragmento de código siguiente muestra una aplicación simplificada que crea un objeto ConfigurationBuilder para recuperar un valor de cadena de un archivo JSON en tiempo de ejecución.
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!
*/
Aquí se muestra el contenido del archivo JSON.
{
"weather": "stormy"
}
Constructores
| ConfigurationBuilder() |
Inicializa una nueva instancia de la clase ConfigurationBuilder. |
Propiedades
| Properties |
Obtiene una colección de claves y valores que se puede usar para compartir datos entre el IConfigurationBuilder y los proveedores de configuración registrados. |
| Sources |
Obtiene los orígenes usados para obtener valores de configuración. |
Métodos
| Add(IConfigurationSource) |
Agrega un nuevo origen de configuración. |
| Build() |
Compila un IConfiguration con claves y valores del conjunto de proveedores registrados en Sources. |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
| 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) |
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 |
| AddConfiguration(IConfigurationBuilder, IConfiguration, Boolean) |
Agrega una configuración existente a |
| 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. |
| Add<TSource>(IConfigurationBuilder, Action<TSource>) |
Agrega un nuevo origen de configuración. |
| 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 |
| AddIniFile(IConfigurationBuilder, Action<IniConfigurationSource>) |
Agrega un origen de configuración INI a |
| AddIniFile(IConfigurationBuilder, String) |
Agrega el proveedor de configuración INI en |
| AddIniFile(IConfigurationBuilder, String, Boolean) |
Agrega el proveedor de configuración INI en |
| AddIniFile(IConfigurationBuilder, String, Boolean, Boolean) |
Agrega el proveedor de configuración INI en |
| AddIniStream(IConfigurationBuilder, Stream) |
Agrega un origen de configuración INI a |
| AddJsonFile(IConfigurationBuilder, IFileProvider, String, Boolean, Boolean) |
Agrega un origen de configuración JSON a |
| AddJsonFile(IConfigurationBuilder, Action<JsonConfigurationSource>) |
Agrega un origen de configuración JSON a |
| AddJsonFile(IConfigurationBuilder, String) |
Agrega el proveedor de configuración JSON en |
| AddJsonFile(IConfigurationBuilder, String, Boolean) |
Agrega el proveedor de configuración JSON en |
| AddJsonFile(IConfigurationBuilder, String, Boolean, Boolean) |
Agrega el proveedor de configuración JSON en |
| AddJsonStream(IConfigurationBuilder, Stream) |
Agrega un origen de configuración JSON a |
| 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 |
| AddInMemoryCollection(IConfigurationBuilder, IEnumerable<KeyValuePair<String,String>>) |
Agrega el proveedor de configuración de memoria a |
| AddUserSecrets(IConfigurationBuilder, Assembly) |
Agrega el origen de configuración de secretos de usuario. Esto busca 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 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 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 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 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 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 |
| AddXmlFile(IConfigurationBuilder, Action<XmlConfigurationSource>) |
Agrega un origen de configuración XML a |
| AddXmlFile(IConfigurationBuilder, String) |
Agrega el proveedor de configuración XML en |
| AddXmlFile(IConfigurationBuilder, String, Boolean) |
Agrega el proveedor de configuración XML en |
| AddXmlFile(IConfigurationBuilder, String, Boolean, Boolean) |
Agrega el proveedor de configuración XML en |
| AddXmlStream(IConfigurationBuilder, Stream) |
Agrega un origen de configuración XML a |
Se aplica a
Consulte también
- configuración de en .NET
