Página Geral de Propriedades (Projeto)

Este artigo se aplica a projetos do Visual Studio para Windows. Para projetos Linux, consulte Referência da página de propriedades do Linux C++. Para projetos CMake, consulte Projetos CMake no Visual Studio. Para projetos Android, consulte Propriedades gerais do projeto (Android C++). Para projetos Android Makefile, consulte Propriedades gerais do projeto (Android C++ Makefile). No Visual Studio 2019, algumas propriedades para projetos não UWP (Tempo de Execução do Windows ou Plataforma Universal do Windows) foram movidas para a página de propriedades Avançado.

Para abrir a caixa de diálogo Páginas de Propriedades de um projeto, selecione o projeto (não a solução) no Gerenciador de Soluções. Em seguida, selecione o menu Propriedades>do nome do projeto na barra de menus. Ou, clique com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e selecione Propriedades no menu de atalho.

Na caixa de diálogo Páginas de Propriedades, a página de propriedadesGeral das Propriedades> de Configuração exibe as propriedades do projeto com base no tipo de projeto. Essas propriedades são reunidas em um ou dois títulos, dependendo do tipo de projeto:

• General

• Padrões do projeto

General

O título Propriedade Geral inclui alguma combinação destas propriedades:

Plataforma de destino

Especifica a plataforma na qual o projeto é executado. Por exemplo, Windows, Android ou iOS. O valor Windows 10 significa que o projeto tem como alvo a Plataforma Universal do Windows. Se você estiver segmentando outras versões do Windows, a versão não está listada e o valor neste campo aparece apenas como Windows. Esta propriedade é um campo somente leitura que é definido quando você cria um projeto.

Versão da plataforma de destino

Especifica a versão do SDK do Windows usada para criar o projeto. Esta propriedade aparece somente se o tipo de projeto oferece suporte a ela. Você pode selecionar 10.0 para especificar a versão mais recente do SDK do Windows. Se o seu aplicativo puder aproveitar os recursos desta versão do SDK do Windows, mas ainda puder ser executado em versões anteriores sem esses recursos, talvez com alguma perda de funcionalidade, o valor dessa propriedade e da propriedade Versão Mínima da Plataforma de Destino pode ser diferente. Em caso afirmativo, seu código deve verificar a versão da plataforma em que está sendo executado em tempo de execução e desativar recursos que não estão disponíveis em versões mais antigas da plataforma.

Plataforma de Destino Min. Versão

Especifica a versão mais baixa da plataforma na qual o projeto pode ser executado. Esta propriedade aparece somente se o tipo de projeto oferece suporte a ela. Defina esse valor se seu aplicativo puder aproveitar os recursos de uma versão mais recente do SDK do Windows, mas ainda for executado em versões anteriores, talvez com alguma perda de funcionalidade. Se definido para um valor mais baixo, seu código deve verificar a versão da plataforma em que está sendo executado em tempo de execução. Em seguida, desative os recursos que não estão disponíveis em versões mais antigas da plataforma.

O sistema de projeto C++ não impõe essa opção. Ele está incluído para consistência com outras linguagens, como C# e JavaScript, e como um guia para qualquer pessoa que use seu projeto. O Microsoft C++ não gerará um erro se você usar um recurso que não está disponível na versão mínima.

Versão do SDK do Windows

Para a plataforma de destino do Windows, essa propriedade especifica a versão do SDK do Windows que seu projeto requer. Quando o Visual Studio Installer instala uma carga de trabalho C++, ele também instala as partes necessárias do SDK do Windows. Se você tiver outras versões do SDK do Windows no seu computador, cada versão instalada aparecerá na lista suspensa.

Para direcionar o Windows 7 ou o Windows Vista, use o valor 8.1, já que o Windows SDK 8.1 é compatível com versões anteriores dessas plataformas. Quando você segmentar uma versão anterior, defina o valor apropriado para _WIN32_WINNT in targetver.h. Para o Windows 7, isso é 0x0601. Para obter mais informações, consulte Modificando WINVER e _WIN32_WINNT.

Você pode instalar o conjunto de ferramentas da plataforma Windows XP incluído como um componente opcional no Visual Studio Installer para criar projetos do Windows XP e do Windows 2003 Server. Para obter informações sobre como obter e usar esse conjunto de ferramentas de plataforma, consulte Configurando programas para o Windows XP. Para obter mais informações sobre como alterar o conjunto de ferramentas da plataforma, consulte Como modificar a estrutura de destino e o conjunto de ferramentas da plataforma.

Diretório de saída

Especifica o diretório onde as ferramentas de compilação, como o vinculador, colocam todos os arquivos de saída final criados durante o processo de compilação. Normalmente, esse diretório contém a saída de ferramentas como o vinculador, bibliotecário ou BSCMake. Por padrão, essa propriedade é o diretório especificado pela combinação $(SolutionDir)$(Configuration)\de macros.

Para aceder programaticamente a esta propriedade, consulte OutputDirectory.

Diretório intermediário

Especifica o diretório onde ferramentas como o compilador colocam todos os arquivos intermediários criados durante o processo de compilação. Normalmente, esse diretório contém a saída de ferramentas como o compilador C/C++, MIDL e o compilador de recursos. Por padrão, essa propriedade é o diretório especificado pela macro $(Configuration)\.

Para aceder programaticamente a esta propriedade, consulte IntermediateDirectory.

Nome do destino

Especifica o nome do arquivo que este projeto gera. Por padrão, essa propriedade é o nome do arquivo especificado pela macro $(ProjectName).

Extensão do alvo

Especifica a extensão de arquivo gerada por este projeto, como .exe ou .dll. Para alguns tipos de projeto do Visual Studio 2019, essa propriedade foi movida para a página de propriedades Avançado.

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 exclui qualquer saída conhecida da compilação, não importa onde ela esteja localizada. 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. Para alguns tipos de projeto do Visual Studio 2019, essa propriedade foi movida para a página de propriedades Avançado.

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. O local padrão é especificado pela combinação $(IntDir)$(MSBuildProjectName).logde macros. Para alguns tipos de projeto do Visual Studio 2019, essa propriedade foi movida para a página de propriedades Avançado.

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.

Conjunto de ferramentas da plataforma

Especifica o conjunto de ferramentas usado para criar a configuração atual. Essa propriedade permite que o projeto tenha como destino uma versão diferente das bibliotecas e do compilador do Microsoft C++. Por padrão, os projetos do Visual Studio C++ destinam-se ao conjunto de ferramentas mais recente instalado pelo Visual Studio. Você pode escolher um dos conjuntos de ferramentas instalados por várias versões anteriores do Visual Studio em vez disso. Alguns conjuntos de ferramentas mais antigos podem criar executáveis que são executados no Windows XP ou Vista. Para obter mais informações sobre como alterar o conjunto de ferramentas da plataforma, consulte Como modificar a estrutura de destino e o conjunto de ferramentas da plataforma.

Habilitar compilação incremental gerenciada

Para projetos gerenciados, essa propriedade permite a deteção de visibilidade externa quando você gera assemblies. Se uma alteração em um projeto gerenciado não for visível para outros projetos, os projetos dependentes não serão reconstruídos. Essa opção pode melhorar drasticamente os tempos de compilação em soluções que incluem projetos gerenciados. Em projetos do Visual Studio 2019, essa propriedade foi movida para a página de propriedades Avançado.

Padrões do projeto

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. Em projetos do Visual Studio 2019, essa propriedade foi movida para a página de propriedades Avançado.

Para aceder programaticamente a esta propriedade, consulte useOfMfc.

Conjunto de caracteres

Especifica se a macro ou _MBCS pré-processador _UNICODE deve ser definida. Também afeta o ponto de entrada do vinculador, quando apropriado. Em projetos do Visual Studio 2019, essa propriedade foi movida para a página de propriedades Avançado.

Para aceder programaticamente a esta propriedade, consulte CharacterSet.

suporte para Common Language Runtime

Faz com que a opção do /clr compilador seja usada. Em projetos do Visual Studio 2019, essa propriedade foi movida para a página de propriedades Avançado.

Para aceder programaticamente a esta propriedade, consulte ManagedExtensions.

Versão do .NET Target Framework

Em projetos gerenciados, especifica a versão do .NET Framework a ser direcionada. Em projetos do Visual Studio 2019, essa propriedade foi movida para a página de propriedades Avançado.

Otimização de todo o programa

Especifica a opção do compilador e /LTCG a opção do /GL vinculador. Por padrão, essa propriedade é desabilitada para configurações de depuração e habilitada para configurações de versão. Em projetos do Visual Studio 2019, essa propriedade foi movida para a página de propriedades Avançado.

Suporte a aplicativos da Windows Store

Especifica se este projeto oferece suporte a aplicativos do Tempo de Execução do Windows (Plataforma Universal do Windows ou UWP). Para obter mais informações, consulte /ZW (Compilação do Tempo de Execução do Windows) e a documentação da UWP do Windows Developer.

Consulte também

Referência da página de propriedades do projeto C++