Halaman Kompilasi, Perancang Proyek (Visual Basic)

Gunakan halaman Kompilasi Perancang Proyek untuk menentukan instruksi kompilasi. Anda juga dapat menentukan opsi pengkompilasi tingkat lanjut dan peristiwa pra-build atau pasca-build di halaman ini.

Untuk mengakses halaman Kompilasi, pilih simpul proyek (bukan node Solusi) di Penjelajah Solusi. Lalu pilih Proyek, Properti pada bilah menu. Saat Perancang Proyek muncul, klik tab Kompilasi.

Catatan

Komputer Anda mungkin menampilkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam artikel ini. Anda mungkin menggunakan edisi Visual Studio yang berbeda atau pengaturan lingkungan yang berbeda. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE.

Konfigurasi dan Platform

Pengaturan berikut memungkinkan Anda memilih konfigurasi dan platform untuk ditampilkan atau dimodifikasi.

Catatan

Dengan konfigurasi build yang disederhanakan, sistem proyek menentukan apakah akan membuat versi debug atau rilis. Oleh karena itu, daftar Konfigurasi dan Platform tidak ditampilkan.

Konfigurasi

Menentukan pengaturan konfigurasi mana yang akan ditampilkan atau diubah. Pengaturannya adalah Debug (default), Rilis, atau Semua Konfigurasi. Untuk informasi selengkapnya, lihat Memahami Konfigurasi Build dan Cara: Membuat dan Mengedit Konfigurasi.

Platform

Menentukan pengaturan platform mana yang akan ditampilkan atau dimodifikasi. Anda dapat menentukan CPU apa pun (default), x64, atau x86.

Opsi Konfigurasi Pengkompilasi

Pengaturan berikut memungkinkan Anda mengatur opsi konfigurasi pengkompilasi.

Jalur output build

Menentukan lokasi file output untuk konfigurasi proyek ini. Ketik jalur output build dalam kotak ini, atau klik tombol Telusuri untuk memilih jalur. Perhatikan bahwa jalurnya relatif; jika Anda memasukkan jalur absolut, jalur tersebut akan disimpan sebagai relatif. Jalur default adalah bin\Debug\ atau bin\Release\.

Dengan konfigurasi build yang disederhanakan, sistem proyek menentukan apakah akan membuat versi debug atau rilis. Perintah Build dari menu Debug (F5) akan menempatkan build di lokasi debug terlepas dari jalur Output yang Anda tentukan. Namun, perintah Build dari menu Build menempatkannya di lokasi yang Anda tentukan.

Opsi eksplisit

Menentukan apakah akan mengizinkan deklarasi implisit variabel. Pilih Aktif untuk memerlukan deklarasi variabel eksplisit. Hal ini menyebabkan pengkompilasi melaporkan kesalahan jika variabel tidak dideklarasikan sebelum digunakan. Pilih Nonaktif untuk mengizinkan deklarasi variabel implisit.

Pengaturan ini sesuai dengan opsi pengkompilasi /optionexplicit .

Jika file kode sumber berisi Pernyataan Eksplisit Opsi, On nilai atau Off dalam pernyataan akan mengambil alih pengaturan Opsi Eksplisit pada halaman Kompilasi.

Saat Anda membuat proyek baru, pengaturan Opsi Eksplisit pada halaman Kompilasi diatur ke nilai pengaturan Eksplisit Opsi dalam kotak dialog Opsi . Untuk melihat atau mengubah pengaturan dalam kotak dialog ini, pada menu Alat , klik Opsi. Dalam kotak dialog Opsi, perluas Proyek dan Solusi, lalu klik Default VB. Pengaturan default awal Opsi Eksplisit di Default VB adalah Aktif.

Mengatur Opsi Eksplisit ke Off umumnya bukan praktik yang baik. Anda dapat salah mengeja nama variabel di satu atau beberapa lokasi, yang akan menyebabkan hasil yang tidak diharapkan saat program dijalankan.

Opsi ketat

Menentukan apakah akan memberlakukan semantik jenis yang ketat. Saat Opsi Ketat Aktif, kondisi berikut menyebabkan kesalahan waktu kompilasi:

  • Konversi penyempitan implisit

  • Pengikatan akhir

  • Pengetikan implisit yang menghasilkan Object jenis

Kesalahan konversi penyempitan implisit terjadi ketika ada konversi jenis data implisit yang merupakan konversi penyempitan. Untuk informasi selengkapnya, lihat Opsi Pernyataan Ketat, Konversi Implisit dan Eksplisit, dan Konversi Pelebaran dan Penyempitan.

Objek terlambat terikat ketika ditetapkan ke properti atau metode variabel yang dinyatakan berjenis Object. Untuk informasi selengkapnya, lihat Opsi Pernyataan Ketat dan Pengikatan Awal dan Terlambat.

Kesalahan jenis objek implisit terjadi ketika jenis yang sesuai tidak dapat disimpulkan untuk variabel yang dideklarasikan, sehingga jenis Object disimpulkan. Ini terutama terjadi ketika Anda menggunakan Dim pernyataan untuk mendeklarasikan variabel tanpa menggunakan klausul As, dan Option Infer nonaktif. Untuk informasi selengkapnya, lihat Opsi Pernyataan Ketat, Pernyataan Infer Opsi, dan Spesifikasi Bahasa Visual Basic.

Pengaturan Opsi Ketat sesuai dengan opsi pengkompilasi /optionstrict.

Jika file kode sumber berisi Pernyataan Ketat Opsi, On nilai atau Off dalam pernyataan akan mengambil alih pengaturan Opsi Ketat pada halaman Kompilasi.

Saat Anda membuat proyek, pengaturan Opsi Ketat pada halaman Kompilasi diatur ke nilai pengaturan Opsi Ketat dalam kotak dialog Opsi . Untuk melihat atau mengubah pengaturan dalam kotak dialog ini, pada menu Alat , klik Opsi. Dalam kotak dialog Opsi, perluas Proyek dan Solusi, lalu klik Default VB. Pengaturan default awal Opsi Ketat di Default VB Nonaktif.

Opsi Peringatan Individu Yang Ketat

Bagian Konfigurasi peringatan dari halaman Kompilasi memiliki pengaturan yang sesuai dengan tiga kondisi yang menyebabkan kesalahan waktu kompilasi saat Option Strict aktif. Berikut ini adalah setelan berikut:

  • Konversi Implisit

  • Pengikatan Akhir; panggilan bisa gagal pada run time

  • Jenis Implisit; objek yang diasumsikan

Saat Anda mengatur Option Strict ke Aktif, ketiga pengaturan konfigurasi peringatan ini diatur ke Kesalahan. Saat Anda mengatur Option Strict ke Nonaktif, ketiga pengaturan diatur ke Tidak Ada.

Anda dapat mengubah setiap pengaturan konfigurasi peringatan satu per satu menjadi Tidak Ada, Peringatan, atau Kesalahan. Jika ketiga pengaturan konfigurasi peringatan diatur ke Kesalahan, On muncul di kotak Option strict. Jika ketiganya diatur ke Tidak Ada, Off muncul dalam kotak ini. Untuk kombinasi lain dari setelan ini, (kustom) muncul.

Perbandingan opsi

Menentukan jenis perbandingan string yang akan digunakan. Pilih Biner untuk menginstruksikan pengkompilasi untuk menggunakan perbandingan string biner dan peka huruf besar/kecil. Pilih Teks untuk menggunakan perbandingan string teks khusus lokal yang tidak peka huruf besar/kecil.

Pengaturan ini sesuai dengan opsi kompilator /optioncompare .

Jika file kode sumber berisi Pernyataan Bandingkan Opsi, Binary nilai atau Text dalam pernyataan akan mengambil alih pengaturan Perbandingan Opsi pada halaman Kompilasi.

Saat Anda membuat proyek, pengaturan Opsi Bandingkan pada halaman Kompilasi diatur ke nilai pengaturan Perbandingan Opsi dalam kotak dialog Opsi. Untuk melihat atau mengubah pengaturan dalam kotak dialog ini, pada menu Alat , klik Opsi. Dalam kotak dialog Opsi, perluas Proyek dan Solusi, lalu klik Default VB. Pengaturan default awal Perbandingan Opsi di Default VB adalah Biner.

Inferensi opsi

Menentukan apakah akan mengizinkan inferensi jenis lokal dalam deklarasi variabel. Pilih Aktif untuk mengizinkan penggunaan inferensi jenis lokal. Pilih Nonaktif untuk memblokir inferensi jenis lokal.

Pengaturan ini sesuai dengan opsi pengkompilasi /optioninfer .

Jika file kode sumber berisi Pernyataan Infer Opsi, On nilai atau Off dalam pernyataan akan mengambil alih pengaturan Infer Opsi pada halaman Kompilasi.

Saat Anda membuat proyek, pengaturan Infer opsi pada halaman Kompilasi diatur ke nilai pengaturan Infer Opsi dalam kotak dialog Opsi. Untuk melihat atau mengubah pengaturan dalam kotak dialog ini, pada menu Alat , klik Opsi. Dalam kotak dialog Opsi, perluas Proyek dan Solusi, lalu klik Default VB. Pengaturan default awal Opsi Infer di Default VB adalah Aktif.

Target CPU

Menentukan prosesor yang akan ditargetkan oleh file output. Tentukan x86 untuk prosesor yang kompatibel dengan Intel 32-bit, x64 untuk prosesor yang kompatibel dengan Intel 64-bit, ARM untuk prosesor ARM apa pun, atau CPU apa pun untuk menentukan bahwa prosesor apa pun dapat diterima. CPU apa pun adalah nilai default untuk proyek baru karena memungkinkan aplikasi berjalan pada jumlah terbesar jenis perangkat keras.

Untuk informasi selengkapnya, lihat /platform (Visual Basic).

Lebih suka 32-bit

Jika kotak centang Prefer32-bit dipilih, aplikasi berjalan sebagai aplikasi 32-bit pada Windows versi 32-bit dan 64-bit. Jika tidak, aplikasi berjalan sebagai aplikasi 32-bit pada Windows versi 32-bit dan sebagai aplikasi 64-bit pada Windows versi 64-bit.

Berjalan sebagai aplikasi 64-bit menggandakan ukuran pointer, dan dapat menyebabkan masalah kompatibilitas dengan pustaka yang secara eksklusif 32-bit. Masuk akal untuk menjalankan aplikasi sebagai 64-bit hanya jika berjalan secara signifikan lebih cepat atau membutuhkan lebih dari 4 GB memori.

Kotak centang ini hanya tersedia jika semua kondisi berikut ini benar:

  • Pada Halaman Kompilasi, daftar CPU Target diatur ke CPU Apa Pun.

  • Pada Halaman Aplikasi, daftar Jenis aplikasi menentukan bahwa proyek adalah aplikasi.

  • Pada Halaman Aplikasi, daftar Kerangka kerja target menentukan .NET Framework 4.5.

Konfigurasi peringatan

Tabel ini mencantumkan kondisi build dan tingkat pemberitahuan yang sesuai dari Tidak Ada, Peringatan, atau Kesalahan untuk masing-masing.

Secara default, semua peringatan pengkompilasi ditambahkan ke Daftar Tugas selama kompilasi. Pilih Nonaktifkan semua peringatan untuk menginstruksikan pengkompilasi untuk tidak mengeluarkan peringatan atau kesalahan. Pilih Perlakukan semua peringatan sebagai kesalahan jika Anda ingin pengkompilasi memperlakukan peringatan sebagai kesalahan yang harus diperbaiki.

Nonaktifkan semua peringatan

Menentukan apakah akan mengizinkan pengkompilasi mengeluarkan pemberitahuan seperti yang ditentukan dalam tabel Kondisi dan Pemberitahuan yang dijelaskan sebelumnya dalam dokumen ini. Secara default, kotak centang ini dikosongkan. Pilih kotak centang ini untuk menginstruksikan pengkompilasi untuk tidak mengeluarkan peringatan atau kesalahan.

Pengaturan ini sesuai dengan opsi pengkompilasi /nowarn .

Perlakukan semua peringatan sebagai kesalahan

Menentukan cara memperlakukan peringatan. Secara default, kotak centang ini dikosongkan, sehingga semua pemberitahuan peringatan tetap diatur ke Peringatan. Pilih kotak centang ini untuk mengubah semua pemberitahuan peringatan menjadi Kesalahan.

Opsi ini hanya tersedia jika Nonaktifkan semua peringatan dibersihkan .

Membuat file dokumentasi XML

Menentukan apakah akan menghasilkan informasi dokumentasi. Secara default, kotak centang ini dipilih, menginstruksikan pengkompilasi untuk menghasilkan informasi dokumentasi dan menyertakannya dalam file XML. Kosongkan kotak centang ini untuk menginstruksikan pengkompilasi untuk tidak membuat dokumentasi.

Pengaturan ini sesuai dengan opsi pengkompilasi /doc .

Mendaftar untuk interop COM

Menentukan apakah aplikasi terkelola Anda akan mengekspos objek COM (pembungkus yang dapat dipanggil COM) yang memungkinkan objek COM berinteraksi dengan aplikasi.

Secara default, kotak centang ini dikosongkan, yang menentukan bahwa aplikasi tidak akan mengizinkan interop COM. Pilih kotak centang ini untuk memperbolehkan interop COM.

Opsi ini tidak tersedia untuk proyek Aplikasi Windows atau Aplikasi Konsol.

Bangun Peristiwa

Klik tombol ini untuk mengakses kotak dialog Build Events . Gunakan kotak dialog ini untuk menentukan instruksi konfigurasi pra-build dan pasca-build untuk proyek. Kotak dialog ini hanya berlaku untuk proyek Visual Basic. Untuk informasi selengkapnya, lihat Build Events Dialog Box (Visual Basic).

Opsi Kompilasi Tingkat Lanjut

Klik tombol ini untuk mengakses kotak dialog Pengaturan AdvancedCompiler. Gunakan kotak dialog AdvancedCompiler Pengaturan untuk menentukan properti konfigurasi build lanjutan proyek. Kotak dialog ini hanya berlaku untuk proyek Visual Basic. Untuk informasi selengkapnya, lihat Kotak Dialog Pengaturan Pengkompilasi Tingkat Lanjut (Visual Basic).

Lihat juga