-platform (Visual Basic)

Menentukan versi platform dari runtime bahasa umum (CLR) mana yang dapat menjalankan file output.

Sintaks

-platform:{ x86 | x64 | Itanium | arm | anycpu | anycpu32bitpreferred }  

Argumen

Term Definisi
x86 Mengompilasi rakitan Anda untuk dijalankan oleh CLR 32-bit yang kompatibel dengan x86.
x64 Mengompilasi rakitan Anda untuk dijalankan oleh CLR 64-bit di komputer yang mendukung rangkaian instruksi AMD64 atau EM64T.
Itanium Mengkompilasi rakitan Anda untuk dijalankan oleh CLR 64-bit di komputer dengan prosesor Itanium.
arm Mengkompilasi rakitan Anda untuk dijalankan di komputer dengan prosesor ARM (Advanced RISC Machine).
anycpu Mengkompilasi rakitan Anda untuk dijalankan di platform apa pun. Aplikasi ini akan berjalan sebagai aplikasi 32-bit pada versi 32-bit Windows dan sebagai aplikasi 64-bit pada versi 64-bit Windows. Bendera ini adalah nilai default.
anycpu32bitpreferred Mengkompilasi rakitan Anda untuk dijalankan di platform apa pun. Aplikasi ini akan berjalan sebagai aplikasi 32-bit pada versi 32-bit dan 64-bit Windows. Bendera ini hanya berlaku untuk executable (.EXE) dan memerlukan .NET Framework 4.5.

Keterangan

Gunakan opsi -platform untuk menentukan jenis prosesor yang ditargetkan oleh file output.

Secara umum, rakitan .NET Framework yang ditulis dalam Visual Basic akan berjalan sama terlepas dari platform. Namun, ada beberapa kasus yang berperilaku berbeda pada platform yang berbeda. Kasus umum ini adalah:

  • Struktur yang berisi anggota yang ukurannya berubah tergantung pada platform (misalnya, jenis pointer apa pun).

  • Aritmatika pointer yang mencakup ukuran konstanta.

  • Pemanggilan platform yang salah atau deklarasi COM yang menggunakan Integer untuk handel, bukan IntPtr.

  • Transmisi IntPtr ke Integer.

  • Menggunakan panggilan platform atau interop COM dengan komponen yang tidak ada di semua platform.

Opsi -platform akan mengurangi beberapa masalah jika Anda tahu anda telah membuat asumsi tentang arsitektur yang akan dijalankan kode Anda. Khususnya:

  • Jika Anda memutuskan untuk menargetkan platform 64-bit, dan aplikasi dijalankan pada komputer 32-bit, pesan kesalahan datang jauh lebih awal dan lebih ditargetkan pada masalah daripada kesalahan yang terjadi tanpa menggunakan pergantian ini.

  • Jika Anda mengatur bendera x86 pada opsi dan aplikasi kemudian dijalankan pada komputer 64-bit, aplikasi akan berjalan di subsistem WOW alih-alih berjalan secara asli.

Pada sistem operasi Windows 64-bit:

  • Rakitan yang dikompilasi dengan -platform:x86 akan dijalankan pada CLR 32-bit yang berjalan di bawah WOW64.

  • Executable yang dikompilasi dengan -platform:anycpu akan dijalankan pada CLR 64-bit.

  • DLL yang dikompilasi dengan -platform:anycpu akan dijalankan pada CLR yang sama dengan proses yang memuatnya.

  • Executable yang dikompilasi dengan -platform:anycpu32bitpreferred akan dijalankan pada CLR 32-bit.

Untuk informasi selengkapnya tentang cara mengembangkan aplikasi untuk dijalankan pada versi 64-bit Windows, lihat Aplikasi 64-bit.

Untuk mengatur -platform di IDE Visual Studio

  1. Di Penjelajah Solusi, pilih proyek, buka menu Proyek, lalu klik Properti.

  2. Pada tab Kompilasi, pilih atau kosongkan kotak centang Pilih 32-bit, atau, di daftar CPU Target, pilih nilai.

    Untuk informasi selengkapnya, lihat Halaman Kompilasi, Perancang Proyek (Visual Basic).

Contoh

Contoh berikut mengilustrasikan cara menggunakan opsi pengkompilasi -platform.

vbc -platform:x86 myFile.vb  

Lihat juga