Passo a passo: Compilar um programa C++/CLI destinado ao CLR no Visual Studio

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

Para este procedimento, você pode digitar seu próprio programa C++ ou usar um dos programas de exemplo. O programa de exemplo que usamos neste procedimento cria um arquivo de texto chamado textfile.txte o salva no diretório do projeto.

Pré-requisitos

• Uma compreensão dos fundamentos da linguagem C++.
• No Visual Studio 2017 e posterior, o suporte a C++/CLI é um componente opcional. Para instalá-lo, abra o Visual Studio Installer no menu Iniciar do Windows. Verifique se o bloco Desenvolvimento de área de trabalho com C++ está marcado e, na seção Componentes opcionais , verifique também Suporte a C++/CLI.

Criar um novo projeto

As etapas a seguir variam dependendo de qual versão do Visual Studio você está usando. Para ver a documentação da sua versão preferida do Visual Studio, use o controlador de seleção Versão . Encontra-se na parte superior do índice desta página.

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

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

2. Na parte superior da caixa de diálogo, digite CLR na caixa de pesquisa e escolha Projeto Vazio CLR (.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 em 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) e digite um nome de arquivo e, em seguida, clique em Adicionar .

   O arquivo .cpp aparece na pasta Arquivos de código-fonte no Gerenciador de Soluções e uma janela com guias aparece onde você digita o código desejado nesse arquivo.

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

   Por exemplo, você pode usar o programa de exemplo Como escrever um arquivo de texto (C++/CLI) (no nó Tratamento de arquivos e E/S do Guia de programação).

   Se você usar o programa de exemplo, observe que você usa a gcnew palavra-chave em vez de new ao criar 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 C++/CLI, consulte Extensões de componente para plataformas de tempo de execução.

4. No menu Build, clique em Build Solution.

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

   Se você fizer alterações e executar o programa sem fazer uma compilação, uma caixa de diálogo pode indicar que o projeto está desatualizado. Marque a caixa de seleção nesta caixa de diálogo antes de clicar em OK se quiser que o Visual Studio sempre use as versões atuais dos arquivos em vez de avisá-lo sempre que criar o aplicativo.

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

6. Se você usou o programa de exemplo, quando você executa o programa uma janela de comando é exibida que indica que o arquivo de texto foi criado.

   O arquivo de textotextfile.txt agora está localizado no diretório do projeto. Você pode abrir este arquivo usando o bloco de notas.

   Observação

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

Ver também

Referência da linguagem C++
Projetos e construção de sistemas