Warning taskWarning task

Registra una advertencia durante la compilación basándose en una instrucción condicional evaluada.Logs a warning during a build based on an evaluated conditional statement.

ParámetrosParameters

En la siguiente tabla se describen los parámetros de la tarea Warning .The following table describes the parameters of the Warning task.

ParámetroParameter DescripciónDescription
Code Parámetro String opcional.Optional String parameter.

Código de advertencia que se debe asociar a la advertencia.The warning code to associate with the warning.
File Parámetro String opcional.Optional String parameter.

Especifica el archivo correspondiente, si existe.Specifies the relevant file, if any. Si no se proporciona ningún archivo, se utiliza el archivo que contiene la tarea Warning.If no file is provided, the file containing the Warning task is used.
HelpKeyword Parámetro String opcional.Optional String parameter.

Palabra clave de ayuda que se debe asociar a la advertencia.The Help keyword to associate with the warning.
Text Parámetro String opcional.Optional String parameter.

Texto de advertencia que registra MSBuildMSBuild si el parámetro Condition se evalúa como true.The warning text that MSBuildMSBuild logs if the Condition parameter evaluates to true.

ComentariosRemarks

La tarea Warning permite que los proyectos MSBuildMSBuild verifiquen la presencia de una configuración o una propiedad necesaria antes de continuar con el siguiente paso de compilación.The Warning task allows MSBuildMSBuild projects to check for the presence of a required configuration or property before proceeding with the next build step.

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.If the Condition parameter of the Warning task evaluates to true, the value of the Text parameter is logged and the build continues to execute. Si no existe ningún parámetro Condition, se registra el texto de advertencia.If a Condition parameter does not exist, the warning text is logged. Para obtener más información sobre los registros, vea Obtener registros de compilación con MSBuild.For more information on logging, see Obtain build logs.

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.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. Para obtener una lista de estos parámetros adicionales y sus descripciones, vea TaskExtension (Clase base).For a list of these additional parameters and their descriptions, see TaskExtension base class.

EjemploExample

En el ejemplo de código siguiente se verifican las propiedades que se establecen en la línea de comandos.The following code example checks for properties that are set on the command line. 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.If there are no properties set, the project raises a warning event, and logs the value of the Text parameter of the Warning task.

<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>  

Vea tambiénSee also

Obtener registros de compilación Obtain build logs
Referencia de esquemas del archivo de proyecto MSBuildProject file schema reference