Warning (tarea)

  • Artículo

Registra una advertencia durante la compilación basándose en una instrucción condicional evaluada.

Parámetros

En la siguiente tabla se describen los parámetros de la tarea Warning .

Parámetro Descripción
Code Parámetro String opcional.

Código de advertencia que se debe asociar a la advertencia.
File Parámetro String opcional.

Especifica el archivo correspondiente, si existe. Si no se proporciona ningún archivo, se utiliza el archivo que contiene la tarea Warning.
HelpKeyword Parámetro String opcional.

Palabra clave de ayuda que se debe asociar a la advertencia. Solo para uso interno.
HelpLink Parámetro String opcional.

Un vínculo para obtener más información acerca de la advertencia.
Text Parámetro String opcional.

Texto de advertencia que registra MSBuild si el parámetro Condition se evalúa como true.

Comentarios

La tarea Warning permite que los proyectos de MSBuild verifiquen la presencia de una configuración o una propiedad necesaria antes de continuar con el siguiente paso de compilación.

Si el parámetro Condition de la tarea Warning se evalúa como true, se registra el valor del parámetro Text y la compilación continúa ejecutándose. Si no existe ningún parámetro Condition, se registra el texto de advertencia. Para obtener más información sobre los registros, vea Obtener registros de compilación con MSBuild.

Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase TaskExtension, que a su vez hereda de la clase Task. Para obtener una lista de estos parámetros adicionales y sus descripciones, consulte TaskExtension base class.

Visual Studio utiliza HelpKeyword para admitir la característica de ayuda contextual (F1). Puede usar HelpLink para asociar una página de ayuda en línea con un mensaje de error.

Ejemplo

En el ejemplo de código siguiente se verifican las propiedades que se establecen en la línea de comandos. Si no se establece ninguna propiedad, el proyecto genera un evento de advertencia y registra el valor del parámetro Text de la tarea Warning.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="ValidateCommandLine">
        <Warning
            Text=" The 0 property was not set on the command line."
            Condition="'$(0)' == ''" />
        <Warning
            Text=" The FREEBUILD property was not set on the command line."
            Condition="'$(FREEBUILD)' == ''" />
    </Target>
    ...
</Project>

Consulte también