Propriedades comuns do projeto MSBuild
A tabela a seguir lista propriedades usadas com freqüência que são definidas nos arquivos de projeto do Visual Studio ou incluídas em .targets arquivos que o MSBuild fornece.
Os arquivos de projeto no Visual Studio (.csproj, .vbproj, .vcxproje outros) contêm código XML do MSBuild que é executado quando você cria um projeto usando o IDE. Os projetos normalmente importam um ou mais arquivos .targets para definir seu processo de compilação. Para obter mais informações, consulte arquivos .targets do MSBuild.
Ao definir valores de propriedade, lembre-se de que as propriedades comuns podem ser definidas, redefinidas ou usadas em vários arquivos importados. Portanto, importa onde você define uma propriedade - em seu arquivo de projeto, em Directory.Build.propsou em outro arquivo importado. Se você estiver definindo uma propriedade em algum lugar e não obtendo o resultado esperado, considere onde e como a propriedade é alterada ou usada em todos os arquivos importados pelo seu projeto, incluindo importações que são adicionadas implicitamente quando você está usando o atributo Sdk
. Consulte Escolha entre adicionar propriedades a um arquivo .props ou .targets. O pré-processamento pode ajudar com isso (consulte a opção de linha de comando /preprocess
ou /pp
em de referência de linha de comando do MSBuild).
Lista de propriedades e parâmetros comuns
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
AdicionalLibPaths | .NET | Especifica pastas adicionais nas quais os compiladores devem procurar assemblies de referência. |
AddModules | .NET | Faz com que o compilador disponibilize todas as informações de tipo dos arquivos especificados para o projeto que você está compilando. Esta propriedade é equivalente ao /addModules switch do compilador. |
ALToolPath | .NET | O caminho para AL.exe. Esta propriedade substitui a versão atual do AL.exe para permitir o uso de uma versão diferente. |
ApplicationIcon | .NET | O .ico arquivo de ícone para passar para o compilador para incorporação como um ícone Win32. A propriedade é equivalente ao /win32icon switch do compilador. |
Manifesto do aplicativo | Tudo | Especifica o caminho do arquivo usado para gerar informações de manifesto do UAC (Controle de Conta de Usuário) externo. Aplica-se somente a projetos do Visual Studio destinados ao Windows Vista. Na maioria dos casos, o manifesto é incorporado. No entanto, se você usar a implantação COM ou ClickOnce sem registro, o manifesto pode ser um arquivo externo instalado junto com os assemblies do aplicativo. Para obter mais informações, consulte a propriedade NoWin32Manifest neste artigo. |
AssemblyOriginatorKeyFile | .NET | Especifica o arquivo usado para assinar o assembly (.snk ou .pfx ) e que é passado para o tarefa ResolveKeySource para gerar a chave real usada para assinar o assembly. |
AssemblySearchPaths | .NET | Uma lista de locais a serem pesquisados durante a resolução de assembly de referência em tempo de compilação. A ordem em que os caminhos aparecem nesta lista é significativa porque os caminhos listados anteriormente têm precedência sobre entradas posteriores. |
AssemblyName | .NET | O nome do assembly de saída final após o projeto ser construído. |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
Endereço Base | .NET | Especifica o endereço base do assembly de saída principal. Esta propriedade é equivalente ao /baseaddress switch do compilador. |
BaseIntermediateOutputPath | Tudo | A pasta de nível superior onde todas as pastas de saída intermediárias específicas da configuração são criadas. O valor padrão é obj\ . O código a seguir é um exemplo: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
BaseOutputPath | Tudo | Especifica o caminho base para o arquivo de saída. Se estiver definido, o MSBuild usa OutputPath = $(BaseOutputPath)\$(Configuration)\ . Exemplo de sintaxe: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
BuildInParallel | Tudo | Um valor booleano que indica se as referências de projeto são criadas ou limpas em paralelo quando Multi-Proc MSBuild é usado. O valor padrão é true , o que significa que os projetos serão construídos em paralelo se o sistema tiver vários núcleos ou processadores. |
BuildProjectReferences | Tudo | Um valor booleano que indica se as referências de projeto são criadas pelo MSBuild. Defina automaticamente como false se você estiver criando seu projeto no ambiente de desenvolvimento integrado (IDE) do Visual Studio true se o contrário.
-p:BuildProjectReferences=false pode ser especificado na linha de comando para evitar a verificação de que os projetos referenciados estão atualizados. |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
CleanFile | Tudo | O nome do arquivo que será usado como "cache limpo". O cache limpo é uma lista de arquivos gerados a serem excluídos durante a operação de limpeza. O arquivo é colocado no caminho de saída intermediário pelo processo de compilação. Esta propriedade especifica apenas nomes de arquivo que não têm informações de caminho. |
Página de código | .NET | Especifica a página de código a ser usada para todos os arquivos de código-fonte na compilação. Esta propriedade é equivalente ao /codepage switch do compilador. |
CompilerResponseFile | .NET | Um arquivo de resposta opcional que pode ser passado para as tarefas do compilador. |
Configuração | Tudo | A configuração que você está criando, geralmente Debug ou Release , mas configurável nos níveis de solução e projeto. |
CscToolPath | C# | O caminho de csc.exe, o compilador C#. |
CustomAfterMicrosoftCommonTargets | Tudo | O nome de um arquivo de projeto ou arquivo de destino que deve ser importado automaticamente após a importação de destinos comuns. |
CustomBeforeMicrosoftCommonTargets | Tudo | O nome de um arquivo de projeto ou arquivo de destino que deve ser importado automaticamente antes da importação de destinos comuns. |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
DebugSymbols | Tudo | Um valor booleano que indica se os símbolos são gerados pela compilação. Definir -p:DebugSymbols=false na linha de comando desativa a geração de arquivos de símbolo do banco de dados do programa (.pdb). |
DebugType | Tudo | Define o nível de informações de depuração que você deseja gerar. Os valores válidos são "full", "pdbonly", "portable", "embedded" e "none". |
DefineConstants | .NET | Define constantes condicionais do compilador. Os pares símbolo/valor são separados por ponto-e-vírgula e são especificados usando sintaxe dependente do idioma: C#: symbol1; symbol2 Visual Basic: symbol1 = value1, symbol2 = value2 A propriedade é equivalente ao /define switch do compilador. |
DefineDebug | Tudo | Um valor booleano que indica se você deseja que a constante DEBUG seja definida. |
DefineTrace | Tudo | Um valor booleano que indica se você deseja que a constante TRACE seja definida. |
DelaySign | .NET | Um valor booleano que indica se você deseja atrasar a assinatura do assembly em vez de assiná-lo completamente. |
Determinística | .NET | Um valor booleano que indica se o compilador deve produzir assemblies idênticos para entradas idênticas. Este parâmetro corresponde ao switch /deterministic dos compiladores. |
DirectoryBuildPropsPath | Tudo | Especifica o caminho para o arquivo Directory.Build.props; Se definida, essa propriedade substitui o algoritmo de pesquisa padrão. Consulte Personalizar sua compilação. |
DirectoryBuildTargetsPath | Tudo | Especifica o caminho para o arquivo Directory.Build.targets; Se definida, essa propriedade substitui o algoritmo de pesquisa padrão. Consulte Personalizar sua compilação. |
DisableFastUpToDateCheck | Tudo | Um valor booleano que se aplica apenas ao Visual Studio. O gerenciador de compilação do Visual Studio usa um processo chamado FastUpToDateCheck para determinar se um projeto deve ser reconstruído para estar atualizado. Esse processo é mais rápido do que usar o MSBuild para determinar isso. Definir a propriedade DisableFastUpToDateCheck como true permite ignorar o gerenciador de compilação do Visual Studio e forçá-lo a usar o MSBuild para determinar se o projeto está atualizado. |
DocumentaçãoArquivo | .NET | O nome do arquivo que é gerado como o arquivo de documentação XML. Esse nome inclui apenas o nome do arquivo e não tem informações de caminho. |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
Relatório de erros | .NET | Especifica como a tarefa do compilador deve relatar erros internos do compilador. Os valores válidos são "prompt", "send" ou "none". Esta propriedade é equivalente ao /errorreport switch do compilador. |
ExcludeDeploymentUrl | .NET | A tarefa GenerateDeploymentManifest adiciona uma marca deploymentProvider ao manifesto de implantação se o arquivo de projeto incluir qualquer um dos seguintes elementos: - UpdateUrl - InstallUrl - PublishUrl Usando ExcludeDeploymentUrl, no entanto, você pode impedir que a tag deploymentProvider seja adicionada ao manifesto de implantação, mesmo que qualquer uma das URLs acima seja especificada. Para fazer isso, adicione a seguinte propriedade ao seu arquivo de projeto: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Nota: ExcludeDeploymentUrl não é exposto no IDE do Visual Studio e pode ser definido somente editando manualmente o arquivo de projeto. Definir essa propriedade não afeta a publicação no Visual Studio; ou seja, a tag deploymentProvider ainda será adicionada à URL especificada por PublishUrl. |
FileAlignment | .NET | Especifica, em bytes, onde alinhar as seções do arquivo de saída. Os valores válidos são 512, 1024, 2048, 4096, 8192. Esta propriedade é equivalente ao /filealignment switch do compilador. |
FrameworkPathOverride | Visual Basic | Especifica o local de mscorlib.dll e microsoft.visualbasic.dll. Este parâmetro é equivalente ao switch /sdkpath do compilador vbc.exe. |
GenerateDocumentationFile | .NET | Um parâmetro booleano que indica se a documentação é gerada pela compilação. Se true , a compilação gera informações de documentação e as coloca em um arquivo de .xml juntamente com o nome do arquivo executável ou biblioteca que a tarefa de compilação criou. |
GenerateFullPaths | C# | Gere caminhos completos para nomes de arquivos na saída usando a opção -fullpaths compilador. |
GenerateSerializationAssemblies | .NET | Indica se os assemblies de serialização XML devem ser gerados pelo SGen.exe, que pode ser definido como ativado, automático ou desativado. Essa propriedade é usada para assemblies destinados somente ao .NET Framework. Para gerar assemblies de serialização XML para assemblies .NET Standard ou .NET Core, consulte o Microsoft.XmlSerializer.Generator pacote NuGet. |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
ImportDirectoryBuildProps | Tudo | Um valor booleano que indica se um arquivo de Directory.Build.props deve ser importado. Consulte Personalizar sua compilação. |
ImportDirectoryBuildTargets | Tudo | Um valor booleano que indica se um arquivo de Directory.Build.targets deve ser importado. Consulte Personalizar sua compilação. |
IntermediateOutputPath | Tudo | O caminho de saída intermediário completo como derivado de BaseIntermediateOutputPath , se nenhum caminho for especificado. Por exemplo, obj\debug\. |
KeyContainerName | Tudo | O nome do contêiner de chave de nome forte. |
KeyOriginatorFile | Tudo | O nome do arquivo de chave de nome forte. |
ModuleAssemblyName | .NET | O nome do assembly no qual o módulo compilado deve ser incorporado. A propriedade é equivalente ao /moduleassemblyname switch do compilador. |
MSBuildProjectExtensionsPath | Tudo | Especifica o caminho onde as extensões de projeto estão localizadas. Por padrão, isso tem o mesmo valor que BaseIntermediateOutputPath . |
MSBuildTreatWarningsAsErrors | Tudo | Um valor booleano que diz ao MSBuild para tratar todos os avisos como erros, a menos que eles sejam suprimidos. |
MSBuildWarningsAsErrors | Tudo | Especifica uma lista de códigos de aviso a serem tratados como erros. Separe vários avisos por ponto-e-vírgula. Se você estiver usando a propriedade .NET SDK WarningsAsErrors , MSBuildWarningsAsErrors assumirá como padrão o valor de WarningsAsErrors . |
MSBuildWarningsAsMessages | Tudo | Especifica uma lista de códigos de aviso a serem suprimidos, tratando-os como mensagens de baixa importância. Separe vários avisos por ponto-e-vírgula. Observe que alguns avisos emitidos pelo MSBuild não podem ser suprimidos usando essa propriedade; Para suprimi-los, use a opção de linha de comando -warnAsMessage . Se você estiver usando a propriedade .NET SDK NoWarn , MSBuildWarningsAsMessages assumirá como padrão o valor de NoWarn . |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
NoLogo | Tudo | Um valor booleano que indica se você deseja que o logotipo do compilador seja desativado. Esta propriedade é equivalente ao /nologo switch do compilador. |
NoStdLib | .NET | Um valor booleano que indica se deve ser evitada a referência à biblioteca padrão (mscorlib.dll). O valor padrão é false . |
NoVBRuntimeReference | Visual Basic | Um valor booleano que indica se o tempo de execução do Visual Basic (Microsoft.VisualBasic.dll) deve ser incluído como uma referência no projeto. |
NãoAvisar | .NET | Suprime os avisos especificados. Apenas a parte numérica do identificador de aviso deve ser especificada. Vários avisos são separados por ponto-e-vírgula. Este parâmetro corresponde ao switch /nowarn dos compiladores. |
NoWin32Manifest | .NET | Um valor booleano que indica se as informações de manifesto do Controle de Conta de Usuário (UAC) serão incorporadas no executável do aplicativo. Aplica-se somente a projetos do Visual Studio destinados ao Windows Vista. Em projetos implantados usando ClickOnce e Registration-Free COM, esse elemento é ignorado.
False (o valor padrão) especifica que as informações de manifesto do Controle de Conta de Usuário (UAC) sejam incorporadas no executável do aplicativo.
True especifica que as informações de manifesto do UAC não sejam incorporadas.Esta propriedade aplica-se apenas a projetos do Visual Studio destinados ao Windows Vista. Em projetos implantados usando ClickOnce e Registration-Free COM, essa propriedade é ignorada. Você deve adicionar NoWin32Manifest somente se não quiser que o Visual Studio incorpore nenhuma informação de manifesto no executável do aplicativo; Esse processo é chamado de virtualização . Para usar a virtualização, defina <ApplicationManifest> em conjunto com <NoWin32Manifest> da seguinte maneira:- Para projetos Visual Basic, remova o nó <ApplicationManifest> . (Em projetos do Visual Basic, <NoWin32Manifest> é ignorado quando existe um nó <ApplicationManifest> .)- Para projetos C#, defina <ApplicationManifest> para False e <NoWin32Manifest> para True . (Em projetos C#, <ApplicationManifest> substitui <NoWin32Manifest> .)Esta propriedade é equivalente à opção de compilador /nowin32manifest de vbc.exe. |
Otimizar | .NET | Um valor booleano que, quando definido como true , permite otimizações do compilador. Esta propriedade é equivalente ao /optimize switch do compilador. |
OpçãoComparar | VisualBasic | Especifica como as comparações de cadeia de caracteres são feitas. Os valores válidos são "binário" ou "texto". Esta propriedade é equivalente à opção de compilador /optioncompare de vbc.exe. |
OpçãoExplícito | Visual Basic | Um valor booleano que, quando definido como true , requer declaração explícita de variáveis no código-fonte. Esta propriedade é equivalente ao /optionexplicit switch do compilador. |
OptionInfer | Visual Basic | Um valor booleano que, quando definido como true , permite a inferência de tipo de variáveis. Esta propriedade é equivalente ao /optioninfer switch do compilador. |
OpçãoEstrito | Visual Basic | Um valor booleano que, quando definido como true , faz com que a tarefa de compilação imponha semântica de tipo estrita para restringir conversões de tipo implícitas. Esta propriedade é equivalente ao switch /optionstrict do compilador vbc.exe. |
OutDir | Tudo | Indica o local de saída final para o projeto ou solução. Ao criar uma solução, o OutDir pode ser usado para reunir várias saídas do projeto em um único local. Além disso, OutDir está incluído em AssemblySearchPaths usado para resolver referências. Por exemplo, bin\Debug. |
Caminho de saída | Tudo | Especifica o caminho para o diretório de saída, relativo ao diretório do projeto, por exemplo, bin\Debug ou bin\Debug\$(Platform) em compilações não-AnyCPU. |
Tipo de saída | Tudo | Especifica o formato de arquivo do arquivo de saída. Este parâmetro pode ter um dos seguintes valores: - Biblioteca. Cria uma biblioteca de códigos. (Valor padrão.) - Exe. Cria um aplicativo de console. - Módulo. Cria um módulo. - Winexe. Cria um programa baseado no Windows. Para C# e Visual Basic, essa propriedade é equivalente à opção /target . O tipo de saída pode ser substituído automaticamente por inferência. Consulte OutputType definido como WinExe para aplicativos WPF e WinForms. Desative a inferência definindo DisableWinExeOutputInference como true . |
OverwriteReadOnlyFiles | Tudo | Um valor booleano que indica se você deseja habilitar a compilação para substituir arquivos somente leitura ou disparar um erro. |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
Mapa de Caminhos | .NET | Especifica como mapear caminhos físicos para nomes de caminho de origem enviados pelo compilador. Esta propriedade é equivalente ao switch /pathmap dos compiladores. |
Arquivo Pdb | .NET | O nome do arquivo de .pdb arquivo que você está emitindo. Esta propriedade é equivalente ao switch /pdb do compilador csc.exe. |
Plataforma | Tudo | O sistema operacional para o qual você está criando. Exemplos de compilações do .NET Framework são "Qualquer CPU", "x86" e "x64". |
ProcessorArchitecture | .NET | A arquitetura do processador que é usada quando as referências de assembly são resolvidas. Os valores válidos são "msil", "x86", "amd64" ou "ia64". |
ProduceOnlyReferenceAssembly | .NET | Um valor booleano que instrui o compilador a emitir apenas um assembly de referência em vez de código compilado. Não pode ser usado em conjunto com ProduceReferenceAssembly . Esta propriedade corresponde à opção /refonly dos compiladores vbc.exe e csc.exe. |
ProduceReferenceAssembly | .NET | Um valor booleano que, quando definido como true , permite a produção de assemblies de referência para o assembly atual.
Deterministic deve ser true ao usar esse recurso. Esta propriedade corresponde à opção /refout dos compiladores vbc.exe e csc.exe. |
RegisterAssemblyMSBuildArchitecture | Apenas Windows | Especifica a arquitetura padrão para a qual a DLL gerenciada está registrada. Essa propriedade é útil porque COM usa o registro do Windows para armazenar os registros em hives específicos da arquitetura. Por exemplo, em um sistema Windows, um assembly gerenciado por AnyCPU pode ter seus tipos registrados no hive de 64 bits e/ou na seção de 32 bits (WoW), e a compilação usa essa propriedade para determinar qual hive de registro específico da arquitetura usar. Os valores válidos incluem "x86", "x64" e "ARM64". |
RegisterForCOMInterop | Apenas Windows | Indica que seu aplicativo gerenciado irá expor um objeto COM (um wrapper chamável COM). Consulte página Build - Output section. Essa configuração afeta apenas a máquina na qual o projeto está sendo construído. Se você estiver implantando em outras máquinas, chame regasm.exe para registrar o assembly na máquina de destino. |
RemoveIntegerChecks | Visual Basic | Um valor booleano que indica se as verificações de erro de estouro de número inteiro devem ser desabilitadas. O valor padrão é false . Esta propriedade é equivalente ao switch /removeintchecks do compilador vbc.exe. |
RootNamespace | Tudo | O namespace raiz a ser usado quando você nomeia um recurso incorporado. Esse namespace faz parte do nome do manifesto do recurso incorporado. |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
Satellite_AlgorithmId | .NET | A ID do AL.exe algoritmo de hash a ser usado quando assemblies satélite são criados. |
Satellite_BaseAddress | .NET | O endereço base a ser usado quando assemblies satélites específicos de cultura são construídos usando o destino CreateSatelliteAssemblies . |
Satellite_CompanyName | .NET | O nome da empresa a passar para AL.exe durante a geração de montagem de satélites. |
Satellite_Configuration | .NET | O nome da configuração a ser passado para AL.exe durante a geração de montagem de satélite. |
Satellite_Description | .NET | O texto de descrição para passar para AL.exe durante a geração de montagem de satélite. |
Satellite_EvidenceFile | .NET | Incorpora o arquivo especificado no assembly satélite que tem o nome do recurso "Security.Evidence". |
Satellite_FileVersion | .NET | Especifica uma cadeia de caracteres para o campo Versão do arquivo no assembly satélite. |
Satellite_Flags | .NET | Especifica um valor para o campo Sinalizadores no assembly satélite. |
Satellite_GenerateFullPaths | .NET | Faz com que a tarefa de compilação use caminhos absolutos para todos os arquivos relatados em uma mensagem de erro. |
Satellite_LinkResource | .NET | Vincula os arquivos de recursos especificados a um assembly satélite. |
Satellite_MainEntryPoint | .NET | Especifica o nome totalmente qualificado (ou seja, class.method) do método a ser usado como ponto de entrada quando um módulo é convertido em um arquivo executável durante a geração de assembly satélite. |
Satellite_ProductName | .NET | Especifica uma cadeia de caracteres para o campo Produto no assembly satélite. |
Satellite_ProductVersion | .NET | Especifica uma cadeia de caracteres para o campo ProductVersion no assembly satélite. |
Satellite_TargetType | .NET | Especifica o formato de arquivo do arquivo de saída do assembly satélite como "library", "exe" ou "win". O valor padrão é "library". |
Satellite_Title | .NET | Especifica uma cadeia de caracteres para o campo Título no assembly satélite. |
Satellite_Trademark | .NET | Especifica uma cadeia de caracteres para o campo Marca comercial no assembly satélite. |
Satellite_Version | .NET | Especifica as informações de versão para o assembly satélite. |
Satellite_Win32Icon | .NET | Insere um arquivo de ícone .ico no assembly satélite. |
Satellite_Win32Resource | .NET | Insere um recurso Win32 (arquivo .res) no assembly satélite. |
SGenToolPath | .NET | Um caminho de ferramenta opcional que indica onde obter SGen.exe quando a versão atual do SGen.exe é substituída. |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
SGenUseProxyTypes | .NET | Um valor booleano que indica se os tipos de proxy devem ser gerados por SGen.exe. Isso se aplica somente quando GenerateSerializationAssemblies está definido como ativado. O destino SGen usa essa propriedade para definir o sinalizador UseProxyTypes. O padrão dessa propriedade é true e não há nenhuma interface do usuário para alterar isso. Para gerar o assembly de serialização para tipos que não sejam webservice, adicione essa propriedade ao arquivo de projeto e defina-o como false antes de importar o Microsoft.Common.Targets ou o C#/VB.targets. |
SkipInvalidConfigurations | Tudo | Quando true , gere um aviso sobre combinações inválidas de plataforma e configuração, mas não falhe na compilação; Quando false ou indefinido (o padrão), gere um erro. |
StartupObject | .NET | Especifica a classe ou módulo que contém o método Main ou o procedimento Sub Main. Esta propriedade é equivalente ao /main switch do compilador. |
SubsystemVersion | .NET | Especifica a versão mínima do subsistema que o arquivo executável gerado pode usar. Esta propriedade é equivalente ao /subsystemversion switch do compilador. Para obter informações sobre o valor padrão dessa propriedade, consulte /subsystemversion (Visual Basic) ou /subsystemversion (opções do compilador C#). |
TargetCompactFramework | .NET | A versão do .NET Compact Framework necessária para executar o aplicativo que você está criando. Especificar isso permite que você faça referência a determinados assemblies de estrutura que talvez não seja possível fazer referência de outra forma. |
TargetFrameworkVersion | .NET | A versão do .NET Framework necessária para executar o aplicativo que você está criando. Especificar isso permite que você faça referência a determinados assemblies de estrutura que talvez não seja possível fazer referência de outra forma. |
TratarAvisosAsErros | .NET | Um parâmetro booleano que, se true , faz com que todos os avisos sejam tratados como erros. Este parâmetro é equivalente à opção de compilador /nowarn . |
UseCommonOutputDirectory | .NET | Uma propriedade booleana que você pode definir como true quando quiser que todas as saídas de compilação em uma solução usem o mesmo diretório de saída. Se true , a saída dos projetos referenciados não é copiada para projetos que usam essas dependências, como normalmente é o caso quando essa configuração é false . Definir este parâmetro como true não altera o diretório de saída real de nenhum projeto; Você ainda precisa definir o diretório de saída para o diretório de saída comum desejado para cada projeto que o exige. |
UseHostCompilerIfAvailable | .NET | Um parâmetro booleano que, se true , faz com que a tarefa de compilação use o objeto do compilador em processo, se estiver disponível. Esse parâmetro é usado somente pelo Visual Studio. |
Utf8Saída | .NET | Um parâmetro booleano que, se true , registra a saída do compilador usando codificação UTF-8. Este parâmetro é equivalente à opção de compilador /utf8Output . |
Nome da propriedade ou parâmetro | Tipos de projetos | Descrição |
---|---|---|
VbcToolPath | Visual Basic | Um caminho opcional que indica outro local para vbc.exe quando a versão atual do vbc.exe é substituída. |
VbcVerbosity | Visual Basic | Especifica a detalhamento da saída do compilador do Visual Basic. Os valores válidos são "Silencioso", "Normal" (o valor padrão) ou "Detalhado". |
VisualStudioVersion | Tudo | Especifica a versão do Visual Studio sob a qual este projeto deve ser considerado em execução. Se essa propriedade não for especificada, o MSBuild a definirá como um valor padrão de {VisualStudioMajorVersion}.0 ; por exemplo, ele será 17.0 para todas as versões do Visual Studio 2022.Essa propriedade é usada em vários tipos de projeto para especificar o conjunto de destinos que são usados para a compilação. Se ToolsVersion estiver definido como 4.0 ou superior para um projeto, VisualStudioVersion será usado para especificar qual subconjunto de ferramentas usar. Para obter mais informações, consulte Conjunto de ferramentas (ToolsVersion). |
AvisosAsErrors | .NET | Especifica uma lista de avisos a serem tratados como erros. Este parâmetro é equivalente à opção de compilador /warnaserror . |
Nível de Alerta | Tudo | Especifica o nível de aviso a ser passado para os compiladores para avisos emitidos pelo compilador. Essa configuração não afeta os avisos do MSBuild, que não têm designações de nível. Consulte Nível de Aviso na documentação do compilador C# e /W (Nível de aviso) na documentação do compilador C++. |
AvisosNotAsErrors | .NET | Especifica uma lista de avisos que não são tratados como erros. Este parâmetro é equivalente à opção de compilador /warnaserror . |
Win32Manifest | .NET | O nome do arquivo de manifesto que deve ser incorporado na montagem final. Este parâmetro é equivalente à opção de compilador /win32Manifest . |
Win32Recurso | .NET | O nome de arquivo do recurso Win32 a ser incorporado no assembly final. Este parâmetro é equivalente à opção de compilador /win32resource . |
As propriedades específicas para projetos do SDK do .NET, como TargetFramework
, são documentadas em Framework properties.