Panduan: Mengkompilasi program C++/CLI yang menargetkan CLR di Visual Studio

Artikel
04/03/2023

Dengan menggunakan C++/CLI, Anda dapat membuat program C++ yang menggunakan kelas .NET serta jenis C++ asli. C++/CLI ditujukan untuk digunakan dalam aplikasi konsol dan di DLL yang membungkus kode C++ asli dan membuatnya dapat diakses dari program .NET. Untuk membuat antarmuka pengguna Windows berdasarkan .NET, gunakan C# atau Visual Basic.

Untuk prosedur ini, Anda dapat mengetik program C++ Anda sendiri atau menggunakan salah satu program sampel. Program sampel yang kita gunakan dalam prosedur ini membuat file teks bernama textfile.txt, dan menyimpannya ke direktori proyek.

Prasyarat

Pemahaman tentang dasar-dasar bahasa C++.
Di Visual Studio 2017 dan yang lebih baru, dukungan C++/CLI adalah komponen opsional. Untuk menginstalnya, buka Alat Penginstal Visual Studio dari Windows menu Mulai. Pastikan bahwa petak peta Pengembangan desktop dengan C++ dicentang, dan di bagian Komponen opsional , periksa juga Dukungan C++/CLI.

Membuat proyek baru

Langkah-langkah berikut bervariasi tergantung pada versi Visual Studio mana yang Anda gunakan. Untuk melihat dokumentasi untuk versi Visual Studio pilihan Anda, gunakan kontrol pemilih Versi. Kontrol tersebut dapat ditemukan di bagian atas daftar isi pada halaman ini.

Untuk membuat proyek C++/CLI di Visual Studio

Di Penjelajah Solusi, klik kanan di bagian atas untuk membuka kotak dialog Buat Proyek Baru.
Di bagian atas dialog, ketik CLR di kotak pencarian lalu pilih Clr Empty Project (.NET Framework) dari daftar hasil.
Pilih tombol Buat untuk membuat proyek.

Untuk membuat proyek C++/CLI di Visual Studio 2017

Buat proyek baru. Pada menu File, arahkan ke Baru, lalu klik Proyek.
Dari jenis proyek Visual C++, klik CLR, lalu klik Proyek Kosong CLR.
Ketik nama proyek. Secara default, solusi yang berisi proyek memiliki nama yang sama dengan proyek baru, tetapi Anda dapat memasukkan nama yang berbeda. Anda dapat memasukkan lokasi lain untuk proyek jika anda mau.
Klik OK untuk membuat proyek baru.

Untuk membuat proyek C++/CLI di Visual Studio 2015

Buat proyek baru. Pada menu File, arahkan ke Baru, lalu klik Proyek.
Dari jenis proyek Visual C++, klik CLR, lalu klik Proyek Kosong CLR.
Ketik nama proyek. Secara default, solusi yang berisi proyek memiliki nama yang sama dengan proyek baru, tetapi Anda dapat memasukkan nama yang berbeda. Anda dapat memasukkan lokasi lain untuk proyek jika anda mau.
Klik OK untuk membuat proyek baru.

Menambahkan file sumber

Jika Penjelajah Solusi tidak terlihat, klik Penjelajah Solusi pada menu Tampilan.
Tambahkan file sumber baru ke proyek:
- Klik kanan folder File Sumber di Penjelajah Solusi, arahkan ke Tambahkan, dan klik Item Baru.
- Klik File C++ (.cpp) dan ketik nama file lalu klik Tambahkan.
File .cpp muncul di folder File Sumber di Penjelajah Solusi dan jendela bertab muncul di mana Anda mengetik kode yang Anda inginkan dalam file tersebut.
Klik tab yang baru dibuat di Visual Studio dan ketik program Visual C++ yang valid, atau salin dan tempel salah satu program sampel.

Misalnya, Anda dapat menggunakan program sampel Cara: Menulis File Teks (C++/CLI) (dalam simpul Penanganan File dan I/O Panduan Pemrograman).

Jika Anda menggunakan program sampel, perhatikan bahwa Anda menggunakan gcnew kata kunci alih-alih new saat membuat objek .NET, dan yang gcnew mengembalikan handel (^) daripada pointer (*):

StreamWriter^ sw = gcnew StreamWriter(fileName);

Untuk informasi selengkapnya tentang sintaks C++/CLI, lihat Ekstensi Komponen untuk Platform Runtime.
Pada menu Build, klik Solusi Build.

Jendela Output menampilkan informasi tentang kemajuan kompilasi, seperti lokasi log build dan pesan yang menunjukkan status build.

Jika Anda membuat perubahan dan menjalankan program tanpa melakukan build, kotak dialog mungkin menunjukkan bahwa proyek sudah kedaluarsa. Pilih kotak centang pada dialog ini sebelum Anda mengklik OK jika Anda ingin Visual Studio selalu menggunakan versi file saat ini alih-alih meminta Anda setiap kali membuat aplikasi.
Pada menu Debug , klik Mulai tanpa Penelusuran Kesalahan.
Jika Anda menggunakan program sampel, saat Anda menjalankan program, jendela perintah ditampilkan yang menunjukkan file teks telah dibuat.

File teks textfile.txt sekarang terletak di direktori proyek Anda. Anda dapat membuka file ini dengan menggunakan Notepad.

Catatan

Memilih templat proyek CLR kosong secara otomatis mengatur /clr opsi pengkompilasi. Untuk memverifikasi ini, klik kanan proyek di Penjelajah Solusi dan mengklik Properti, lalu periksa opsi dukungan Common Language Runtime di simpul Umum Properti Konfigurasi.