Página de propriedades avançada

A página de propriedades Avançada está disponível no Visual Studio 2019 e posteriores. Para consultar a documentação dessa versão, ajuste o seletor de versão do Visual Studio neste artigo para Visual Studio 2019 ou posterior. Encontra-se na parte superior do índice desta página. Em versões anteriores do Visual Studio, estas propriedades aparecem na página de propriedades Gerais:

A página de propriedades Avançada está disponível no Visual Studio 2019 e posteriores. As propriedades específicas apresentadas dependem do tipo de projeto. Os projetos Windows Runtime (Plataforma Universal do Windows, ou UWP) não mostram esta página.

Propriedades avançadas

Extensão de ficheiro de destino

Especifica a extensão do ficheiro a usar para a saída da build. Por defeito, para .exe aplicações, .lib para bibliotecas estáticas e .dll para DLLs.

Extensões a serem excluídas ao limpar

O comando de menu Build>Clean exclui arquivos do diretório intermediário onde a configuração de um projeto é criada. O sistema de compilação exclui arquivos que têm as extensões especificadas quando você executa o comando Limpar ou quando você reconstrói. O sistema de compilação também apaga qualquer saída conhecida da compilação, independentemente de onde esteja. Os arquivos excluídos incluem quaisquer saídas intermediárias, como .obj arquivos. Use ponto-e-vírgula (;) para separar extensões. Você pode especificar caracteres curinga (*, ?) nas extensões.

Para aceder programaticamente a esta propriedade, consulte DeleteExtensionsOnClean.

Compilar arquivo de log

Permite especificar um local não padrão para o arquivo de log que é criado sempre que você cria um projeto. A localização padrão é especificada pelas macros $(IntDir)$(MSBuildProjectName).log.

Você pode usar macros de projeto para alterar o local do diretório. Para obter mais informações, consulte Macros comuns para comandos e propriedades de compilação.

Arquitetura de Ferramenta de Construção Preferencial

Especifica se deve usar as ferramentas de build x86 ou x64.

Utilizar Bibliotecas de Depuração

Especifica se deve criar uma build de Depuração ou de Lançamento. Apesar do nome, Use Debug Libraries é uma propriedade específica do sistema de compilação que é efetivamente uma abreviação para "Fazer uma compilação de Depuração" ou "Fazer uma compilação de Lançamento." Define várias propriedades do compilador e do linker para compilações de Depuração ou Lançamento, incluindo as definições da biblioteca. Podes usá-lo para criar configurações de Debug ou Release para uma nova plataforma ou num novo template. Não recomendamos que altere esta propriedade numa configuração existente. Use as propriedades individuais do compilador e do linker em vez disso.

Ativar Build Unity (JUMBO)

Permite um processo de compilação mais rápido que combina muitos ficheiros fonte C++ num ou mais ficheiros antes da compilação.

Copiar conteúdo para o OutDir

Copie os itens marcados como conteúdo no projeto para o diretório de saída do projeto ($(OutDir)). Esta configuração pode simplificar a implementação. Esta propriedade está disponível a partir do Visual Studio 2019 versão 16.7.

Copiar as Referências do Project para o OutDir

Copie os itens de referência do projeto executáveis (DLL e ficheiro EXE) para o diretório de saída do projeto ($(OutDir)). Em projetos C++/CLI (/clr), esta propriedade é ignorada. Em vez disso, a propriedade Copy Local em cada referência de projeto controla se os itens são copiados para o diretório de saída. Esta configuração pode simplificar a implementação local. Está disponível a partir do Visual Studio 2019 versão 16.7.

Copiar os símbolos das referências do Project para OutDir

Copie os ficheiros PDB dos itens de referência do projeto juntamente com os itens executáveis de referência do projeto para o diretório de saída do projeto ($(OutDir)). Esta propriedade está sempre ativada para projetos C++/CLI. Esta configuração pode simplificar a implementação da depuração. Está disponível a partir do Visual Studio 2019 versão 16.7.

Copiar o tempo de execução C++ para o OutDir

Copie as DLLs em tempo de execução C++ para o diretório de saída do projeto ($(OutDir)). Esta configuração pode simplificar a implementação local. Está disponível a partir do Visual Studio 2019 versão 16.7.

Utilização do MFC

Especifica se o projeto MFC estática ou dinamicamente se vincula à DLL MFC. Projetos não-MFC selecione Usar bibliotecas padrão do Windows.

Para aceder programaticamente a esta propriedade, consulte useOfMfc.

Conjunto de caracteres

Especifica se a macro ou _UNICODE pré-processador _MBCS deve ser definida. Também afeta o ponto de entrada do vinculador, quando apropriado. Para _UNICODE, o ponto de entrada esperado do código é wmain ou wWinMain. Para _MBCS, o ponto de entrada esperado do código é main ou WinMain.

Para aceder programaticamente a esta propriedade, consulte CharacterSet.

Otimização de todo o programa

Especifica a opção do compilador e /GL a opção do /LTCG vinculador. Por padrão, essa propriedade é desabilitada para configurações de depuração e habilitada para configurações de versão.

Versão do Conjunto de Ferramentas MSVC

Especifica a versão completa do conjunto de ferramentas MSVC usado para construir o projeto. Pode ter várias versões de atualização e pré-visualização de um conjunto de ferramentas instaladas. Podes especificar qual deles usar aqui.

Versão do conjunto de ferramentas LLVM

Especifica a versão completa do conjunto de ferramentas LLVM usado para construir o projeto. Esta propriedade está disponível quando o LLVM (clang-cl) é selecionado como conjunto de ferramentas da plataforma, a partir do Visual Studio 2019 versão 16.9. Para mais informações, consulte Definir uma versão personalizada do conjunto de ferramentas LLVM.

Ativar a Saída Estruturada MSVC

Especifica se deve ativar a saída SARIF estruturada, que permite a janela de Detalhes do Problema e a saída hierárquica na janela de Saída no Visual Studio.

Propriedades C++/CLI

Suporte em Tempo de Execução em Linguagem Comum

Faz com que a opção do /clr compilador seja usada.

Para aceder programaticamente a esta propriedade, consulte ManagedExtensions.

Versão do .NET Target Framework

Esta propriedade só se aplica quando a propriedade Common Language Runtime Support está definida como .NET Framework Runtime Support. Isto é, quando o projeto tem como alvo o .NET Framework, e este especifica a versão do .NET Framework.

.NET Target Framework

Esta propriedade só se aplica quando a propriedade Common Language Runtime Support está definida para .NET Runtime Support. Isto é, quando o projeto tem como alvo o .NET.

Esta propriedade especifica o nome .NET 5+ Target Framework que este projeto tem como alvo, por exemplo net6.0-windows ou net7.0-windows8.0.

Habilitar compilação incremental gerenciada

Esta propriedade ajuda a melhorar drasticamente os tempos de compilação em grandes soluções, garantindo que projetos dependentes não são reconstruídos se uma alteração não alterar as partes do seu código que outros assemblies ou projetos podem ver e interagir.

Ativar o suporte CLR para ficheiros individuais

Esta opção define uma ManagedAssembly propriedade de build que permite construir apenas alguns ficheiros no projeto como código gerido. Deve definir Habilitar Suporte CLR para Ficheiros Individuais em Sim , se alguns, mas não todos, os seus ficheiros de projeto forem construídos como código gerido. Esta propriedade está disponível apenas em projetos que utilizam o Visual Studio 2022 ou posterior e o conjunto de ferramentas da plataforma v143 ou posterior.

.NET Target Windows Versão

Esta propriedade só se aplica quando a propriedade Common Language Runtime Support está definida para .NET Runtime Support. Isto é, quando o projeto tem como alvo o .NET.

Esta propriedade especifica a versão mínima do Windows que o projeto suporta. Este valor é usado pelo NuGet para determinar a compatibilidade de projetos e dependências de pacotes NuGet. Se um projeto A depende do projeto B, a versão .NET do projeto A para Windows deve ser maior ou igual à do projeto B.

A página de propriedades Avançada está disponível no Visual Studio 2019 e posteriores. As propriedades específicas apresentadas dependem do tipo de projeto. Os projetos Windows Runtime (Plataforma Universal do Windows, ou UWP) não mostram esta página.

Propriedades avançadas

Extensão de ficheiro de destino

Especifica a extensão do ficheiro a usar para a saída da build. Por defeito, .exe para aplicações, .lib para bibliotecas estáticas e .dll para DLLs.

Extensões a serem excluídas ao limpar

O comando de menu Build>Clean exclui arquivos do diretório intermediário onde a configuração de um projeto é criada. O sistema de compilação exclui arquivos que têm as extensões especificadas quando você executa o comando Limpar ou quando você reconstrói. O sistema de compilação também apaga qualquer saída conhecida da compilação, independentemente de onde esteja. Os arquivos excluídos incluem quaisquer saídas intermediárias, como .obj arquivos. Use ponto-e-vírgula (;) para separar extensões. Você pode especificar caracteres curinga (*, ?) nas extensões.

Para aceder programaticamente a esta propriedade, consulte DeleteExtensionsOnClean.

Compilar arquivo de log

Permite especificar um local não padrão para o arquivo de log que é criado sempre que você cria um projeto. A localização padrão é especificada pelas macros $(IntDir)$(MSBuildProjectName).log.

Você pode usar macros de projeto para alterar o local do diretório. Para obter mais informações, consulte Macros comuns para comandos e propriedades de compilação.

Arquitetura de Ferramenta de Construção Preferencial

Especifica se deve usar as ferramentas de compilação ARM64, x86 ou x64.

Utilizar Bibliotecas de Depuração

Especifica se deve criar uma build de Depuração ou de Lançamento. Apesar do nome, Use Debug Libraries é uma propriedade específica do sistema de compilação que é efetivamente uma abreviação para "Fazer uma compilação de Depuração" ou "Fazer uma compilação de Lançamento." Define várias propriedades do compilador e do linker para compilações de Depuração ou Lançamento, incluindo as definições da biblioteca. Podes usá-lo para criar configurações de Debug ou Release para uma nova plataforma ou num novo template. Não recomendamos que altere esta propriedade numa configuração existente. Use as propriedades individuais do compilador e do linker em vez disso.

Ativar Build Unity (JUMBO)

Permite um processo de compilação mais rápido que combina muitos ficheiros fonte C++ num ou mais ficheiros antes da compilação.

Copiar conteúdo para o OutDir

Copie os itens marcados como conteúdo no projeto para o diretório de saída do projeto ($(OutDir)). Esta configuração pode simplificar a implementação. Esta propriedade está disponível a partir do Visual Studio 2019 versão 16.7.

Copiar as Referências do Project para o OutDir

Copie os itens de referência do projeto executáveis (DLL e ficheiro EXE) para o diretório de saída do projeto ($(OutDir)). Em projetos C++/CLI (/clr), esta propriedade é ignorada. Em vez disso, a propriedade Copy Local em cada referência de projeto controla se os itens são copiados para o diretório de saída. Esta configuração pode simplificar a implementação local. Está disponível a partir do Visual Studio 2019 versão 16.7.

Copiar os símbolos das referências do Project para OutDir

Copie os ficheiros PDB dos itens de referência do projeto juntamente com os itens executáveis de referência do projeto para o diretório de saída do projeto ($(OutDir)). Esta propriedade está sempre ativada para projetos C++/CLI. Esta configuração pode simplificar a implementação da depuração. Está disponível a partir do Visual Studio 2019 versão 16.7.

Copiar o tempo de execução C++ para o OutDir

Copie as DLLs em tempo de execução C++ para o diretório de saída do projeto ($(OutDir)). Esta configuração pode simplificar a implementação local. Está disponível a partir do Visual Studio 2019 versão 16.7.

Utilização do MFC

Especifica se o projeto MFC estática ou dinamicamente se vincula à DLL MFC. Projetos não-MFC selecione Usar bibliotecas padrão do Windows.

Para aceder programaticamente a esta propriedade, consulte useOfMfc.

Conjunto de caracteres

Especifica se a macro ou _UNICODE pré-processador _MBCS deve ser definida. Também afeta o ponto de entrada do vinculador, quando apropriado. Para _UNICODE, o ponto de entrada esperado do código é wmain ou wWinMain. Para _MBCS, o ponto de entrada esperado do código é main ou WinMain.

Para aceder programaticamente a esta propriedade, consulte CharacterSet.

Otimização de todo o programa

Especifica a opção do compilador e /GL a opção do /LTCG vinculador. Por padrão, essa propriedade é desabilitada para configurações de depuração e habilitada para configurações de versão.

Usar Depuração Dinâmica em C++

Especifica se deve usar Depuração Dinâmica em C++. Use este modo para depurar código otimizado. Se ativares esta definição, a Otimização de Todo o Programa fica desligada. Para obter mais informações, consulte Depuração dinâmica C++.

Ativar a Saída Estruturada MSVC

Especifica se deve ativar a saída SARIF estruturada, que permite a janela de Detalhes do Problema e a saída hierárquica na janela de Saída no Visual Studio.

Propriedades C++/CLI

Suporte em Tempo de Execução em Linguagem Comum

Faz com que a opção do /clr compilador seja usada.

Para aceder programaticamente a esta propriedade, consulte ManagedExtensions.

Versão do .NET Target Framework

Esta propriedade só se aplica quando a propriedade Common Language Runtime Support está definida como .NET Framework Runtime Support. Isto é, quando o projeto tem como alvo o .NET Framework, e este especifica a versão do .NET Framework.

.NET Target Framework

Esta propriedade só se aplica quando a propriedade Common Language Runtime Support está definida para .NET Runtime Support. Isto é, quando o projeto tem como alvo o .NET.

Esta propriedade especifica o nome .NET 5+ Target Framework que este projeto tem como alvo, por exemplo net6.0-windows ou net7.0-windows8.0.

Habilitar compilação incremental gerenciada

Esta propriedade ajuda a melhorar drasticamente os tempos de compilação em grandes soluções, garantindo que projetos dependentes não são reconstruídos se uma alteração não alterar as partes do seu código que outros assemblies ou projetos podem ver e interagir.

Ativar o suporte CLR para ficheiros individuais

Esta opção define uma ManagedAssembly propriedade de build que permite construir apenas alguns ficheiros no projeto como código gerido. Deve definir Habilitar Suporte CLR para Ficheiros Individuais em Sim , se alguns, mas não todos, os seus ficheiros de projeto forem construídos como código gerido. Esta propriedade está disponível apenas em projetos que utilizam o Visual Studio 2022 ou posterior e o conjunto de ferramentas da plataforma v143 ou posterior.

.NET Target Windows Versão

Esta propriedade só se aplica quando a propriedade de suporte Common Language Runtime está definida como .NET Runtime Support. Isto é, quando o projeto tem como alvo o .NET.

Esta propriedade especifica a versão mínima do Windows que o projeto suporta. Este valor é usado pelo NuGet para determinar a compatibilidade de projetos e dependências de pacotes NuGet. Se um projeto A depende do projeto B, a versão .NET do projeto A para Windows deve ser maior ou igual à do projeto B.

  • Última atualização a