Propiedades comunes del proyecto de MSBuild
En la tabla siguiente se enumeran las propiedades usadas con frecuencia definidas en los archivos de proyecto de Visual Studio o incluidas en .targets archivos que proporciona MSBuild.
Los archivos de proyecto de Visual Studio (.csproj, .vbproj, .vcxprojy otros) contienen código XML de MSBuild que se ejecuta al compilar un proyecto mediante el IDE. Los proyectos suelen importar uno o varios archivos .targets para definir su proceso de compilación. Para obtener más información, consulte archivos .targets de MSBuild.
Al establecer valores de propiedad, tenga en cuenta que las propiedades comunes se pueden establecer, restablecer o usar en una serie de archivos importados. Por lo tanto, importa dónde establezca una propiedad en el archivo de proyecto, en Directory.Build.props, o en otro archivo importado. Si establece una propiedad en algún lugar y no obtiene el resultado esperado, tenga en cuenta dónde y cómo se cambia o usa la propiedad en todos los archivos importados por el proyecto, incluidas las importaciones que se agregan implícitamente cuando se usa el atributo Sdk
. Consulte Elegir entre agregar propiedades a un archivo .props o .targets. El preprocesamiento puede ayudar con esto (consulte la opción de línea de comandos /preprocess
o /pp
en referencia de línea de comandos de MSBuild).
Lista de propiedades y parámetros comunes
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
AdditionalLibPaths | .RED | Especifica carpetas adicionales en las que los compiladores deben buscar ensamblados de referencia. |
AddModules | .RED | Hace que el compilador haga que toda la información de tipo de los archivos especificados esté disponible para el proyecto que está compilando. Esta propiedad es equivalente al modificador del compilador de /addModules . |
ALToolPath | .RED | Ruta de acceso a AL.exe. Esta propiedad invalida la versión actual de AL.exe para habilitar el uso de una versión diferente. |
ApplicationIcon | .RED | El archivo de icono de .ico que se va a pasar al compilador para insertarlo como un icono de Win32. La propiedad es equivalente al modificador del compilador de /win32icon . |
ApplicationManifest | Todo | Especifica la ruta de acceso del archivo que se usa para generar información de manifiesto de control de cuentas de usuario (UAC) externa. Solo se aplica a los proyectos de Visual Studio destinados a Windows Vista. En la mayoría de los casos, el manifiesto está incrustado. Sin embargo, si usa la implementación com o ClickOnce gratis de registro, el manifiesto puede ser un archivo externo que se instala junto con los ensamblados de la aplicación. Para obtener más información, vea la propiedad NoWin32Manifest en este artículo. |
AssemblyOriginatorKeyFile | .RED | Especifica el archivo usado para firmar el ensamblado (.snk o .pfx ) y que se pasa a la tarea ResolveKeySource de para generar la clave real que se usa para firmar el ensamblado. |
AssemblySearchPaths | .RED | Lista de ubicaciones que se van a buscar durante la resolución del ensamblado de referencia en tiempo de compilación. El orden en el que aparecen las rutas de acceso en esta lista es significativa porque las rutas de acceso enumeradas anteriormente tienen prioridad sobre las entradas posteriores. |
AssemblyName | .RED | Nombre del ensamblado de salida final después de compilar el proyecto. |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
BaseAddress | .RED | Especifica la dirección base del ensamblado de salida principal. Esta propiedad es equivalente al modificador del compilador de /baseaddress . |
BaseIntermediateOutputPath | Todo | Carpeta de nivel superior donde se crean todas las carpetas de salida intermedias específicas de la configuración. El valor predeterminado es obj\ . El código siguiente es un ejemplo: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
BaseOutputPath | Todo | Especifica la ruta de acceso base para el archivo de salida. Si se establece, MSBuild usa OutputPath = $(BaseOutputPath)\$(Configuration)\ . Sintaxis de ejemplo: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
BuildInParallel | Todo | Valor booleano que indica si se compilan o limpian referencias de proyecto en paralelo cuando se usa MSBuild de varios procedimientos. El valor predeterminado es true , lo que significa que los proyectos se compilarán en paralelo si el sistema tiene varios núcleos o procesadores. |
BuildProjectReferences | Todo | Valor booleano que indica si MSBuild compila referencias de proyecto. Establezca automáticamente en false si va a compilar el proyecto en el entorno de desarrollo integrado (IDE) de Visual Studio, true si lo contrario.
-p:BuildProjectReferences=false se puede especificar en la línea de comandos para evitar comprobar que los proyectos a los que se hace referencia están actualizados. |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
CleanFile | Todo | Nombre del archivo que se usará como "caché limpia". La caché limpia es una lista de archivos generados que se van a eliminar durante la operación de limpieza. El proceso de compilación coloca el archivo en la ruta de acceso de salida intermedia. Esta propiedad especifica solo los nombres de archivo que no tienen información de ruta de acceso. |
CodePage | .RED | Especifica la página de códigos que se va a usar para todos los archivos de código fuente de la compilación. Esta propiedad es equivalente al modificador del compilador de /codepage . |
CompilerResponseFile | .RED | Un archivo de respuesta opcional que se puede pasar a las tareas del compilador. |
Configuración | Todo | Configuración que va a compilar, por lo general, Debug o Release , pero configurable en los niveles de solución y proyecto. |
CscToolPath | C# | Ruta de acceso de csc.exe, el compilador de C#. |
CustomAfterMicrosoftCommonTargets | Todo | El nombre de un archivo de proyecto o de destino que se va a importar automáticamente después de la importación de destinos comunes. |
CustomBeforeMicrosoftCommonTargets | Todo | Nombre de un archivo de proyecto o archivo de destino que se va a importar automáticamente antes de la importación de destinos comunes. |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
DepurarSymbols | Todo | Valor booleano que indica si la compilación genera símbolos. Al establecer -p:DebugSymbols=false en la línea de comandos, se deshabilita la generación de archivos de símbolos de base de datos de programa (.pdb). |
DebugType | Todo | Define el nivel de información de depuración que desea generar. Los valores válidos son "full", "pdbonly", "portable", "embedded" y "none". |
DefineConstants | .RED | Define constantes del compilador condicional. Los pares de símbolos y valores se separan por punto y coma y se especifican mediante la sintaxis dependiente del lenguaje: C#: symbol1; symbol2 Visual Basic: symbol1 = value1, symbol2 = value2 La propiedad es equivalente al modificador del compilador de /define . |
DefineDebug | Todo | Valor booleano que indica si desea definir la constante DEBUG. |
DefineTrace | Todo | Valor booleano que indica si desea definir la constante TRACE. |
DelaySign | .RED | Valor booleano que indica si desea retrasar la firma del ensamblado en lugar de firmarlo completo. |
Determinista | .RED | Valor booleano que indica si el compilador debe generar ensamblados idénticos para entradas idénticas. Este parámetro corresponde al modificador /deterministic de los compiladores. |
DirectoryBuildPropsPath | Todo | Especifica la ruta de acceso al archivo Directory.Build.props; Si se define, esta propiedad invalida el algoritmo de búsqueda predeterminado. Consulte Personalización delde compilación. |
DirectoryBuildTargetsPath | Todo | Especifica la ruta de acceso al archivo Directory.Build.targets; Si se define, esta propiedad invalida el algoritmo de búsqueda predeterminado. Consulte Personalización delde compilación. |
DisableFastUpToDateCheck | Todo | Valor booleano que solo se aplica a Visual Studio. El administrador de compilación de Visual Studio usa un proceso denominado FastUpToDateCheck para determinar si se debe volver a compilar un proyecto para que esté actualizado. Este proceso es más rápido que usar MSBuild para determinarlo. Establecer la propiedad DisableFastUpToDateCheck en true permite omitir el administrador de compilación de Visual Studio y forzarlo a usar MSBuild para determinar si el proyecto está actualizado. |
DocumentationFile | .RED | Nombre del archivo que se genera como archivo de documentación XML. Este nombre incluye solo el nombre de archivo y no tiene información de ruta de acceso. |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
ErrorReport | .RED | Especifica cómo la tarea del compilador debe notificar errores internos del compilador. Los valores válidos son "prompt", "send" o "none". Esta propiedad es equivalente al modificador del compilador de /errorreport . |
ExcludeDeploymentUrl | .RED | La tarea GenerateDeploymentManifest agrega una etiqueta deploymentProvider al manifiesto de implementación si el archivo del proyecto incluye cualquiera de los siguientes elementos: - UpdateUrl - InstallUrl - PublishUrl Sin embargo, si usa ExcludeDeploymentUrl, puede impedir que la etiqueta deploymentProvider se agregue al manifiesto de implementación incluso si se especifica alguna de las direcciones URL anteriores. Para ello, agregue la siguiente propiedad al archivo del proyecto: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Nota: ExcludeDeploymentUrl no se expone en el IDE de Visual Studio y solo se puede establecer editando manualmente el archivo del proyecto. Establecer esta propiedad no afecta a la publicación en Visual Studio; es decir, la etiqueta deploymentProvider se agregará a la dirección URL especificada por PublishUrl. |
FileAlignment | .RED | Especifica, en bytes, dónde alinear las secciones del archivo de salida. Los valores válidos son 512, 1024, 2048, 4096, 8192. Esta propiedad es equivalente al modificador del compilador de /filealignment . |
FrameworkPathOverride | Visual Basic | Especifica la ubicación de mscorlib.dll y microsoft.visualbasic.dll. Este parámetro es equivalente al modificador /sdkpath del compilador de vbc.exe. |
GenerateDocumentationFile | .RED | Parámetro booleano que indica si la compilación genera documentación. Si true , la compilación genera información de documentación y la coloca en un archivo .xml junto con el nombre del archivo ejecutable o la biblioteca que creó la tarea de compilación. |
GenerateFullPaths | C# | Genere rutas de acceso completas para los nombres de archivo en la salida mediante la opción -fullpaths compilador. |
GenerateSerializationAssemblies | .RED | Indica si los ensamblados de serialización XML se deben generar mediante SGen.exe, que se pueden establecer en activado, automático o desactivado. Esta propiedad se usa solo para ensamblados que tienen como destino .NET Framework. Para generar ensamblados de serialización XML para ensamblados de .NET Standard o .NET Core, haga referencia al paquete NuGet de Microsoft.XmlSerializer.Generator. |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
ImportDirectoryBuildProps | Todo | Valor booleano que indica si se va a importar un archivo Directory.Build.props. Consulte Personalización delde compilación. |
ImportDirectoryBuildTargets | Todo | Valor booleano que indica si se va a importar un archivo Directory.Build.targets. Consulte Personalización delde compilación. |
IntermediateOutputPath | Todo | Ruta de acceso de salida intermedia completa como se deriva de BaseIntermediateOutputPath , si no se especifica ninguna ruta de acceso. Por ejemplo, obj\debug\. |
KeyContainerName | Todo | Nombre del contenedor de claves de nombre seguro. |
KeyOriginatorFile | Todo | Nombre del archivo de clave de nombre seguro. |
ModuleAssemblyName | .RED | Nombre del ensamblado en el que se va a incorporar el módulo compilado. La propiedad es equivalente al modificador del compilador de /moduleassemblyname . |
MSBuildProjectExtensionsPath | Todo | Especifica la ruta de acceso donde se encuentran las extensiones del proyecto. De forma predeterminada, esto toma el mismo valor que BaseIntermediateOutputPath . |
MSBuildTreatWarningsAsErrors | Todo | Valor booleano que indica a MSBuild que trate todas las advertencias como errores, a menos que se supriman. |
MSBuildWarningsAsErrors | Todo | Especifica una lista de códigos de advertencia que se tratarán como errores. Separe varias advertencias por punto y coma. Si usa la propiedad sdk de .NET WarningsAsErrors , MSBuildWarningsAsErrors valor predeterminado será el valor de WarningsAsErrors . |
MSBuildWarningsAsMessages | Todo | Especifica una lista de códigos de advertencia que se suprimirán al tratarlos como mensajes de baja importancia. Separe varias advertencias por punto y coma. Tenga en cuenta que algunas advertencias emitidas por MSBuild no se pueden suprimir mediante esta propiedad; para suprimirlos, use el modificador de línea de comandos -warnAsMessage . Si usa la propiedad sdk de .NET NoWarn , MSBuildWarningsAsMessages valor predeterminado será el valor de NoWarn . |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
NoLogo | Todo | Valor booleano que indica si desea que se desactive el logotipo del compilador. Esta propiedad es equivalente al modificador del compilador de /nologo . |
NoStdLib | .RED | Valor booleano que indica si se debe evitar hacer referencia a la biblioteca estándar (mscorlib.dll). El valor predeterminado es false . |
NoVBRuntimeReference | Visual Basic | Valor booleano que indica si el entorno de ejecución de Visual Basic (Microsoft.VisualBasic.dll) debe incluirse como referencia en el proyecto. |
NoWarn | .RED | Suprime las advertencias especificadas. Solo se debe especificar la parte numérica del identificador de advertencia. Varias advertencias están separadas por punto y coma. Este parámetro corresponde al modificador /nowarn de los compiladores. |
NoWin32Manifest | .RED | Valor booleano que indica si la información del manifiesto de Control de cuentas de usuario (UAC) se incrustará en el ejecutable de la aplicación. Solo se aplica a los proyectos de Visual Studio destinados a Windows Vista. En los proyectos implementados mediante ClickOnce y Registration-Free COM, este elemento se omite.
False (el valor predeterminado) especifica que la información del manifiesto de Control de cuentas de usuario (UAC) se inserte en el ejecutable de la aplicación.
True especifica que la información del manifiesto UAC no se inserte.Esta propiedad solo se aplica a los proyectos de Visual Studio destinados a Windows Vista. En los proyectos implementados mediante ClickOnce y Registration-Free COM, esta propiedad se omite. Solo debe agregar NoWin32Manifest si no desea que Visual Studio inserte información de manifiesto en el ejecutable de la aplicación; este proceso se denomina virtualización. Para usar la virtualización, establezca <ApplicationManifest> junto con <NoWin32Manifest> de la siguiente manera:- Para los proyectos de Visual Basic, quite el nodo <ApplicationManifest> . (En los proyectos de Visual Basic, <NoWin32Manifest> se omite cuando existe un nodo <ApplicationManifest> ).- Para los proyectos de C#, establezca <ApplicationManifest> en False y <NoWin32Manifest> en True . (En los proyectos de C#, <ApplicationManifest> invalida <NoWin32Manifest> ).Esta propiedad es equivalente al modificador del compilador de /nowin32manifest de vbc.exe. |
Optimizar | .RED | Valor booleano que, cuando se establece en true , habilita las optimizaciones del compilador. Esta propiedad es equivalente al modificador del compilador de /optimize . |
OptionCompare | VisualBasic | Especifica cómo se realizan las comparaciones de cadenas. Los valores válidos son "binary" o "text". Esta propiedad es equivalente al modificador del compilador de /optioncompare de vbc.exe. |
OptionExplicit | Visual Basic | Valor booleano que, cuando se establece en true , requiere la declaración explícita de variables en el código fuente. Esta propiedad es equivalente al modificador del compilador de /optionexplicit . |
OptionInfer | Visual Basic | Valor booleano que, cuando se establece en true , habilita la inferencia de tipos de variables. Esta propiedad es equivalente al modificador del compilador de /optioninfer . |
OptionStrict | Visual Basic | Valor booleano que, cuando se establece en true , hace que la tarea de compilación aplique semántica de tipos estrictas para restringir las conversiones de tipos implícitas. Esta propiedad es equivalente al modificador /optionstrict del compilador de vbc.exe. |
OutDir | Todo | Indica la ubicación de salida final del proyecto o la solución. Al compilar una solución, OutDir se puede usar para recopilar varias salidas de proyecto en una ubicación. Además, OutDir se incluye en AssemblySearchPaths que se usa para resolver referencias. Por ejemplo, bin\Debug. |
OutputPath | Todo | Especifica la ruta de acceso al directorio de salida, en relación con el directorio del proyecto, por ejemplo, bin\Debug o bin\Debug\$(Platform) en compilaciones que no sean anyCPU. |
OutputType | Todo | Especifica el formato de archivo del archivo de salida. Este parámetro puede tener uno de los siguientes valores: -Biblioteca. Crea una biblioteca de código. (Valor predeterminado). - Exe. Crea una aplicación de consola. -Módulo. Crea un módulo. - Winexe. Crea un programa basado en Windows. Para C# y Visual Basic, esta propiedad es equivalente al modificador /target . El tipo de salida se puede invalidar automáticamente mediante la inferencia. Vea OutputType establecido en WinExe para aplicaciones WPF y WinForms. Deshabilite la inferencia estableciendo DisableWinExeOutputInference en true . |
OverwriteReadOnlyFiles | Todo | Valor booleano que indica si desea habilitar la compilación para sobrescribir archivos de solo lectura o desencadenar un error. |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
PathMap | .RED | Especifica cómo asignar rutas de acceso físicas a los nombres de ruta de acceso de origen que genera el compilador. Esta propiedad es equivalente al modificador /pathmap de los compiladores. |
PdbFile | .RED | Nombre de archivo del archivo .pdb que está emitiendo. Esta propiedad es equivalente al modificador /pdb del compilador de csc.exe. |
Plataforma | Todo | El sistema operativo para el que está compilando. Algunos ejemplos de compilaciones de .NET Framework son "Any CPU", "x86" y "x64". |
ProcessorArchitecture | .RED | Arquitectura del procesador que se usa cuando se resuelven las referencias de ensamblado. Los valores válidos son "msil", "x86", "amd64" o "ia64". |
ProduceOnlyReferenceAssembly | .RED | Valor booleano que indica al compilador que emita solo un ensamblado de referencia en lugar de código compilado. No se puede usar junto con ProduceReferenceAssembly . Esta propiedad corresponde al modificador /refonly de los compiladores de vbc.exe y csc.exe. |
ProduceReferenceAssembly | .RED | Valor booleano que, cuando se establece en true habilita la producción de ensamblados de referencia de para el ensamblado actual.
Deterministic debe ser true al usar esta característica. Esta propiedad corresponde al modificador /refout de los compiladores de vbc.exe y csc.exe. |
RegisterAssemblyMSBuildArchitecture | Solo Windows | Especifica la arquitectura predeterminada para la que se registra el archivo DLL administrado. Esta propiedad es útil porque COM usa el Registro de Windows para almacenar los registros en subárboles específicos de la arquitectura. Por ejemplo, en un sistema Windows, un ensamblado administrado anyCPU puede tener sus tipos registrados en el subárbol de 64 bits o en el subárbol de 32 bits (WoW) y la compilación usa esta propiedad para determinar qué subárbol del registro específico de la arquitectura se va a usar. Los valores válidos incluyen "x86", "x64" y "ARM64". |
RegisterForCOMInterop | Solo Windows | Indica que la aplicación administrada expondrá un objeto COM (un contenedor al que se puede llamar COM). Consulte página Compilación: sección salida. Esta configuración afecta solo a la máquina en la que se compila el proyecto. Si va a implementar en otras máquinas, llame a regasm.exe para registrar el ensamblado en la máquina de destino. |
RemoveIntegerChecks | Visual Basic | Valor booleano que indica si se deben deshabilitar las comprobaciones de errores de desbordamiento de enteros. El valor predeterminado es false . Esta propiedad es equivalente al modificador /removeintchecks del compilador de vbc.exe. |
RootNamespace | Todo | Espacio de nombres raíz que se va a usar al asignar un nombre a un recurso incrustado. Este espacio de nombres forma parte del nombre del manifiesto de recurso incrustado. |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
Satellite_AlgorithmId | .RED | Identificador del algoritmo hash de AL.exe que se va a usar cuando se crean ensamblados satélite. |
Satellite_BaseAddress | .RED | Dirección base que se va a usar cuando se compilan ensamblados satélite específicos de la referencia cultural mediante el destino CreateSatelliteAssemblies . |
Satellite_CompanyName | .RED | Nombre de la empresa que se va a pasar a AL.exe durante la generación de ensamblados satélite. |
Satellite_Configuration | .RED | Nombre de configuración que se va a pasar a AL.exe durante la generación de ensamblados satélite. |
Satellite_Description | .RED | Texto de descripción que se va a pasar a AL.exe durante la generación de ensamblados satélite. |
Satellite_EvidenceFile | .RED | Inserta el archivo especificado en el ensamblado satélite que tiene el nombre de recurso "Security.Evidence". |
Satellite_FileVersion | .RED | Especifica una cadena para el campo Versión de archivo del ensamblado satélite. |
Satellite_Flags | .RED | Especifica un valor para el campo Marcas del ensamblado satélite. |
Satellite_GenerateFullPaths | .RED | Hace que la tarea de compilación use rutas de acceso absolutas para los archivos notificados en un mensaje de error. |
Satellite_LinkResource | .RED | Vincula los archivos de recursos especificados a un ensamblado satélite. |
Satellite_MainEntryPoint | .RED | Especifica el nombre completo (es decir, class.method) del método que se va a usar como punto de entrada cuando un módulo se convierte en un archivo ejecutable durante la generación del ensamblado satélite. |
Satellite_ProductName | .RED | Especifica una cadena para el campo Product en el ensamblado satélite. |
Satellite_ProductVersion | .RED | Especifica una cadena para el campo ProductVersion en el ensamblado satélite. |
Satellite_TargetType | .RED | Especifica el formato de archivo del archivo de salida del ensamblado satélite como "biblioteca", "exe" o "win". El valor predeterminado es "library". |
Satellite_Title | .RED | Especifica una cadena para el campo Título del ensamblado satélite. |
Satellite_Trademark | .RED | Especifica una cadena para el campo Marca comercial en el ensamblado satélite. |
Satellite_Version | .RED | Especifica la información de versión del ensamblado satélite. |
Satellite_Win32Icon | .RED | Inserta un archivo de icono de .ico en el ensamblado satélite. |
Satellite_Win32Resource | .RED | Inserta un recurso Win32 (archivo .res) en el ensamblado satélite. |
SGenToolPath | .RED | Ruta de acceso de la herramienta opcional que indica dónde obtener SGen.exe cuando se invalida la versión actual de SGen.exe. |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
SGenUseProxyTypes | .RED | Valor booleano que indica si los tipos de proxy deben generarse mediante SGen.exe. Esto solo se aplica cuando GenerateSerializationAssemblies está establecido en activado. El destino SGen usa esta propiedad para establecer la marca UseProxyTypes. Esta propiedad tiene como valor predeterminado true y no hay ninguna interfaz de usuario para cambiarla. Para generar el ensamblado de serialización para tipos que no son de servicio web, agregue esta propiedad al archivo de proyecto y establézcalo en false antes de importar el Microsoft.Common.Targets o el C#/VB.targets. |
SkipInvalidConfigurations | Todo | Cuando true , genere una advertencia en combinaciones de configuración y plataforma no válidas, pero no produzca un error en la compilación; cuando false o undefined (valor predeterminado), genere un error. |
StartupObject | .RED | Especifica la clase o el módulo que contiene el método Main o el procedimiento Sub Main. Esta propiedad es equivalente al modificador del compilador de /main . |
SubsystemVersion | .RED | Especifica la versión mínima del subsistema que puede usar el archivo ejecutable generado. Esta propiedad es equivalente al modificador del compilador de /subsystemversion . Para obtener información sobre el valor predeterminado de esta propiedad, vea /subsystemversion (Visual Basic) o /subsystemversion (opciones del compilador de C#). |
TargetCompactFramework | .RED | Versión de .NET Compact Framework necesaria para ejecutar la aplicación que está compilando. Si especifica esto, puede hacer referencia a determinados ensamblados de marco a los que es posible que no pueda hacer referencia de lo contrario. |
TargetFrameworkVersion | .RED | Versión de .NET Framework necesaria para ejecutar la aplicación que está compilando. Si especifica esto, puede hacer referencia a determinados ensamblados de marco a los que es posible que no pueda hacer referencia de lo contrario. |
TreatWarningsAsErrors | .RED | Parámetro booleano que, si true , hace que todas las advertencias se traten como errores. Este parámetro es equivalente al modificador del compilador de /nowarn . |
UseCommonOutputDirectory | .RED | Propiedad booleana que puede establecer en true cuando desea que todas las salidas de compilación de una solución usen el mismo directorio de salida. Si true , la salida de los proyectos a los que se hace referencia no se copia en proyectos que usan esas dependencias, como suele ser el caso cuando esta configuración es false . Establecer este parámetro en true no cambia el directorio de salida real de ningún proyecto; Todavía debe establecer el directorio de salida en el directorio de salida común deseado para cada proyecto que lo requiera. |
UseHostCompilerIfAvailable | .RED | Parámetro booleano que, si true , hace que la tarea de compilación use el objeto del compilador en proceso, si está disponible. Visual Studio solo usa este parámetro. |
Utf8Output | .RED | Parámetro booleano que, si true , registra la salida del compilador mediante la codificación UTF-8. Este parámetro es equivalente al modificador del compilador de /utf8Output . |
Nombre de la propiedad o del parámetro | Tipos de proyecto | Descripción |
---|---|---|
VbcToolPath | Visual Basic | Ruta de acceso opcional que indica otra ubicación para vbc.exe cuando se invalida la versión actual de vbc.exe. |
VbcVerbosity | Visual Basic | Especifica el nivel de detalle de la salida del compilador de Visual Basic. Los valores válidos son "Quiet", "Normal" (el valor predeterminado) o "Verbose". |
VisualStudioVersion | Todo | Especifica la versión de Visual Studio en la que se debe considerar que se está ejecutando este proyecto. Si no se especifica esta propiedad, MSBuild lo establece en un valor predeterminado de {VisualStudioMajorVersion}.0 ; por ejemplo, se 17.0 para todas las versiones de Visual Studio 2022.Esta propiedad se usa en varios tipos de proyecto para especificar el conjunto de destinos que se usan para la compilación. Si ToolsVersion se establece en 4.0 o superior para un proyecto, se usa VisualStudioVersion para especificar qué subconsultas usar. Para obtener más información, vea Toolset (ToolsVersion). |
WarningsAsErrors | .RED | Especifica una lista de advertencias que se van a tratar como errores. Este parámetro es equivalente al modificador del compilador de /warnaserror . |
WarningLevel | Todo | Especifica el nivel de advertencia que se va a pasar a los compiladores para las advertencias emitidas por el compilador. Esta configuración no afecta a las advertencias de MSBuild, que no tienen designaciones de nivel. Consulte de nivel de advertencia en la documentación del compilador de C# y /W (nivel de advertencia) en la documentación del compilador de C++. |
WarningsNotAsErrors | .RED | Especifica una lista de advertencias que no se tratan como errores. Este parámetro es equivalente al modificador del compilador de /warnaserror . |
Win32Manifest | .RED | Nombre del archivo de manifiesto que se debe incrustar en el ensamblado final. Este parámetro es equivalente al modificador del compilador de /win32Manifest . |
Win32Resource | .RED | Nombre de archivo del recurso Win32 que se va a incrustar en el ensamblado final. Este parámetro es equivalente al modificador del compilador de /win32resource . |
Las propiedades específicas de los proyectos del SDK de .NET, como TargetFramework
, se documentan en las propiedades de Framework.