Información general sobre registro en MSBuild
Actualización: noviembre 2007
Los registradores de MSBuild proporcionan una manera de personalizar la información de los eventos de compilación, los mensajes, las advertencias y los errores. Los registradores pueden mostrar información en la ventana de la consola, escribir en un archivo XML o de texto o escriba los datos de generación en una base de datos.
Registradores de MSBuild
Un registrador se utiliza para retransmitir la información de los eventos, los mensajes, las advertencias y los errores de generación a un registro que se lee y se interpreta con facilidad. La lógica de un registrador se escribe en un tipo administrado que implementa la interfaz ILogger.
Registrador de la consola predeterminado de MSBuild
Cuando se ejecuta MSBuild.exe desde la línea de comandos, MSBuild utiliza el registrador de la consola predeterminado para mostrar información de eventos de compilación en la ventana de la consola. Puede personalizar el nivel de detalle que el registrador debe incluir en el informe utilizando el modificador /verbosity en la línea de comandos.
El registrador de la consola predeterminado acepta parámetros adicionales que pueden modificar el resultado que aparece en la ventana de la consola. Estos parámetros se especifican con el modificador /consoleloggerparameters en la línea de comandos.
Si utiliza un registrador personalizado, puede suceder que desee ocultar la información mostrada y que no aparezca en el registrador de la consola predeterminado. Utilice el modificador /noconsolelogger en la línea de comandos para deshabilitar el registrador de la consola predeterminado.
Registrador de archivo de MSBuild
MSBuild también incluye un registrador de archivo que guarda la información de los eventos de compilación en un archivo. Para ejecutar el registrador de archivo, utilice el siguiente modificador en la línea de comandos, donde MyLog.log es el archivo donde se almacenará la información de registro.
/l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log
En total, el registrador de archivo acepta cuatro parámetros más. Estos son:
Logfile: parámetro obligatorio que especifica el archivo donde se almacenará la información de registro.
Append: Parámetro boolean opcional que indica si el registro se anexará al archivo especificado: es true si desea agregar el registro al texto ya contenido en el archivo; es false para sobrescribir el contenido del archivo. El valor predeterminado es false.
Verbosity: parámetro opcional que reemplaza la configuración global de nivel de detalle únicamente para este registrador de archivo. Esto permite registrar varios registradores, cada uno de ellos con un nivel de detalle diferente.
Encoding: parámetro opcional que especifica la codificación del archivo, por ejemplo, UTF-8.
Varios parámetros se separan con el signo de punto y coma (;). Por ejemplo, la siguiente línea de comandos registra la información de los eventos de compilación en el archivo MyLog.log. Además, anexa el registro al texto presente en el archivo con un nivel de detalle de diagnostic y con la codificación UTF-8.
MSBuild MyProj.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log append=true;verbosity=diagnostic;encoding=utf-8
Especificar un registrador
Si desea utilizar un registrador que no sea el predeterminado de la consola durante una generación, deberá indicar uno personalizado mediante el modificador /logger en la línea de comandos. Para obtener información más detallada sobre los modificadores de la línea de comandos de MSBuild, vea Referencia de la línea de comandos de MSBuild.
Escribir un registrador
La lógica de un registrador se escribe en código administrado y se especifica en la línea de comandos de MSBuild utilizando el modificador /logger.
Puede escribir su propio registrador creando un tipo administrado que implemente la interfaz ILogger. Para obtener más información, vea Cómo: Escribir un registrador.
Vea también
Tareas
Conceptos
Registrar en un entorno de varios procesadores
Crear registradores de reenvío