Instruções passo a passo: compilar um programa em C++/CLI que se destina à CLR no Visual Studio

Usando C++/CLI, você pode criar programas C++ que usam classes .NET, bem como tipos C++ nativos. O C++/CLI destina-se ao uso em aplicativos de console e em DLLs que encapsulam o código C++ nativo e o tornam acessível por meio de programas .NET. Para criar uma interface do usuário do Windows com base no .NET, use C# ou Visual Basic.

Para este procedimento, é possível digitar seu próprio programa do C++ ou usar um dos programas de exemplo. O programa de exemplo que usamos neste procedimento cria um arquivo de texto chamado textfile.txt e salva-o no diretório do projeto.

Pré-requisitos

• Compreensão dos princípios básicos da linguagem C++.
• No Visual Studio 2017 e posterior, o suporte a C++/CLI é um componente opcional. Para instalá-lo, abra o Instalador do Visual Studio no menu Iniciar do Windows. Verifique se o bloco Desenvolvimento de área de trabalho com C++ está marcado e, na seção de componentes Opcionais, marque também Suporte a C++/CLI.

Crie um novo projeto

As etapas a seguir variam dependendo da versão do Visual Studio que você está usando. Para ver a documentação da sua versão preferencial do Visual Studio, use o controle seletor de Versão. Ele é encontrado na parte superior da tabela de conteúdo nesta página.

Para criar um projeto de C++/CLI no Visual Studio

1. Em Gerenciador de Soluções, clique com o botão direito do mouse na parte superior para abrir a caixa de diálogo Criar um Projeto.

2. Na parte superior da caixa de diálogo, digite CLR na caixa de pesquisa e escolha CLR Empty Project (.NET Framework) na lista de resultados.

3. Escolha o botão Criar para criar o projeto.

Adicionar um arquivo de origem

1. Se o Gerenciador de Soluções não estiver visível, clique no Gerenciador de Soluções no menu Exibir.

2. Adicione um novo arquivo de origem ao projeto:

   • Clique com o botão direito do mouse na pasta Arquivos de origem no Gerenciador de Soluções, aponte para Adicionar e clique em Novo Item.

   • Clique em Arquivo C++ (.cpp), digite um nome de arquivo e, em seguida, clique em Adicionar.

   O arquivo .cpp é exibido na pasta Arquivos de Origem do Gerenciador de Soluções e uma janela com guias é exibida no campo no qual você digita o código que deseja inserir nesse arquivo.

3. Clique na guia recém-criada no Visual Studio e digite um programa válido do Visual C++ ou copie e cole um dos programas de exemplo.

   Por exemplo, use o programa de exemplo Como escrever um arquivo de texto (C++/CLI) (no nó Manipulação de Arquivos e E/S do Guia de Programação).

   Se você usar o programa de exemplo, observe que você usará a palavra-chave gcnew em vez de new durante a criação de um objeto .NET e que gcnew retorna um identificador (^) em vez de um ponteiro (*):

   StreamWriter^ sw = gcnew StreamWriter(fileName);

   Para obter mais informações sobre a sintaxe de C++/CLI, confira Extensões de componentes para plataformas de runtime.

4. No menu Compilar, clique em Compilar Solução.

   A janela de Saída exibe informações sobre o progresso da compilação, como o local do log de build e uma mensagem que indica o status do build.

   Se você fizer alterações e executar o programa sem fazer um build, uma caixa de diálogo poderá indicar que o projeto está desatualizado. Marque a caixa de seleção nessa caixa de diálogo antes de clicar em OK se desejar que o Visual Studio sempre use as versões atuais dos arquivos, em vez de exibir uma solicitação sempre que compilar o aplicativo.

5. No menu Depuração, clique em Iniciar sem Depurar.

6. Se você usou o programa de exemplo, quando executar o programa, será exibida uma janela Comando que indica que o arquivo de texto foi criado.

   O arquivo de texto textfile.txt agora está localizado no diretório do projeto. Abra esse arquivo usando o Bloco de notas.

   Observação

   A escolha do modelo de projeto CLR vazio define automaticamente a opção do compilador /clr. Para verificar isso, clique com o botão direito do mouse no projeto no Gerenciador de Soluções, clique em Propriedades e, em seguida, marque a opção Suporte a Common Language Runtime no nó Geral de Propriedades de Configuração.

Confira também

Referência da linguagem C++
Sistemas de build e projetos