Share via

Tugas Vbc

  • Artikel

Membungkus vbc.exe, yang menghasilkan executable (.exe), pustaka tautan dinamis (.dll), atau modul kode (.netmodule). Untuk informasi selengkapnya tentang vbc.exe, lihat Visual Basic pengompilasi baris perintah.

Parameter

Tabel berikut ini menjelaskan parameter tugas Vbc.

Parameter Deskripsi
AdditionalLibPaths Parameter String[] opsional.

Menentukan folder tambahan untuk mencari rakitan yang ditentukan dalam atribut Referensi.
AddModules Parameter String[] opsional.

Menyebabkan kompiler membuat semua informasi jenis dari file yang ditentukan tersedia untuk proyek yang saat ini Anda kompilasi. Parameter ini sesuai dengan sakelar -addmodule dari pengompilasi vbc.exe.
BaseAddress Parameter String opsional.

Menentukan alamat dasar DLL. Parameter ini sesuai dengan sakelar -baseaddress dari pengompilasi vbc.exe.
CodePage Parameter Int32 opsional.

Menentukan halaman kode yang akan digunakan untuk semua file kode sumber di dalam kompilasi. Parameter ini sesuai dengan sakelar -codepage dari pengompilasi vbc.exe.
DebugType Parameter String[] opsional.

Menyebabkan pengompilasi menghasilkan informasi penelusuran kesalahan. Parameter ini dapat memiliki nilai berikut:

- full
- pdbonly

Nilai defaultnya adalah full, yang memungkinkan melampirkan debugger ke program yang sedang berjalan. Nilai pdbonly memungkinkan penelusuran kesalahan kode sumber saat program dimulai di debugger, tetapi menampilkan kode bahasa perakitan hanya ketika program yang sedang berjalan dilampirkan ke debugger. Untuk informasi selengkapnya, lihat -debug (Visual Basic).
DefineConstants Parameter String[] opsional.

Menentukan konstanta pengkompilasi kondisional. Pasangan simbol/nilai dipisahkan oleh titik koma dan ditentukan dengan sintaks berikut:

symbol1=value1;symbol2=value2

Parameter ini sesuai dengan sakelar -define pengompilasi vbc.exe.
DelaySign Parameter Boolean opsional.

Jika true, tugas menempatkan kunci publik di perakitan. Jika false, tugas sepenuhnya menandatangani rakitan. Nilai defaultnya adalah false. Parameter ini tidak berpengaruh kecuali digunakan dengan KeyFile parameter atau KeyContainer parameter. Parameter ini sesuai dengan sakelar -delaysign dari pengompilasi vbc.exe.
Deterministic Parameter Boolean opsional.

Jika true, menyebabkan pengompilasi mengeluarkan rakitan yang konten binernya identik di seluruh kompilasi jika input identik.

Untuk informasi selengkapnya, lihat -deterministic.
DisabledWarnings Parameter String opsional.

Menekan peringatan yang ditentukan. Anda hanya perlu menentukan bagian numerik dari pengidentifikasi peringatan. Beberapa peringatan dipisahkan oleh titik koma. Parameter ini sesuai dengan sakelar -nowarn dari pengompilasi vbc.exe.
DocumentationFile Parameter String opsional.

Memproses komentar dokumentasi ke file XML yang ditentukan. Parameter ini mengambil alih atribut GenerateDocumentation. Untuk informasi lebih lanjut, lihat -doc.
EmitDebugInformation Parameter Boolean opsional.

Jika true, tugas menghasilkan informasi penelusuran kesalahan dan menempatkannya dalam file .pdb. Untuk informasi selengkapnya, lihat -debug (Visual Basic).
ErrorReport Parameter String opsional.

Menentukan bagaimana tugas harus melaporkan kesalahan pengompilasi internal. Parameter ini dapat memiliki nilai berikut:

- prompt
- send
- none

Jika prompt ditentukan dan terjadi kesalahan pengompilasi internal, pengguna akan diminta dengan opsi apakah akan mengirim data kesalahan ke Microsoft.

Jika send ditentukan dan terjadi kesalahan pengompilasi internal, tugas mengirimkan data kesalahan ke Microsoft.

Nilai defaultnya adalah none, yang melaporkan kesalahan dalam output teks saja.

Parameter ini sesuai dengan sakelar -errorreport dari pengompilasi vbc.exe.
FileAlignment Parameter Int32 opsional.

Menentukan, dalam byte, tempat untuk menyelaraskan bagian dari file output. Parameter ini dapat memiliki nilai berikut:

- 512
- 1024
- 2048
- 4096
- 8192

Parameter ini sesuai dengan sakelar -filealign dari pengkompilasi vbc.exe.
GenerateDocumentation Parameter Boolean opsional.

Jika true, menghasilkan informasi dokumentasi dan menempatkannya dalam file XML dengan nama file atau pustaka yang dapat dieksekusi yang dibuat tugas. Untuk informasi lebih lanjut, lihat -doc.
Imports Parameter ITaskItem[] opsional.

Mengimpor namespace dari kumpulan item yang ditentukan. Parameter ini sesuai dengan sakelar -imports dari pengompilasi vbc.exe.
KeyContainer Parameter String opsional.

Menentukan nama kontainer kunci kriptografi. Parameter ini sesuai dengan sakelar -keycontainer dari pengompilasi vbc.exe.
KeyFile Parameter String opsional.

Menentukan nama file yang berisi kunci kriptografi. Untuk informasi selengkapnya, lihat -keyfile.
LangVersion Parameter System.String opsional.

Menentukan versi bahasa, seperti "15.5".
LinkResources Parameter ITaskItem[] opsional.

Membuat link ke sumber daya .NET Framework di file output; file sumber tidak ditempatkan di file output. Parameter ini sesuai dengan sakelar -linkresource dari pengompilasi vbc.exe.
MainEntryPoint Parameter String opsional.

Menentukan kelas atau modul yang berisi prosedur Sub Main. Parameter ini sesuai dengan sakelar utama pengompilasi vbc.exe.
ModuleAssemblyName Parameter String opsional.

Menentukan rakitan bahwa modul ini adalah bagian darinya.
NoConfig Parameter Boolean opsional.

Menentukan bahwa pengompilasi tidak boleh menggunakan file vbc.rsp. Parameter ini sesuai dengan parameter -noconfig dari pengompilasi vbc.exe.
NoLogo Parameter Boolean opsional.

Jika true, menekan tampilan informasi banner pengompilasi. Parameter ini sesuai dengan sakelar -nologo dari pengompilasi vbc.exe.
NoStandardLib Parameter Boolean opsional.

Menyebabkan kompilator tidak mereferensikan pustaka standar. Parameter ini sesuai dengan sakelar -nostdlib dari pengompilasi vbc.exe.
NoVBRuntimeReference Parameter Boolean opsional.

Penggunaan internal saja. Jika benar, mencegah referensi otomatis ke Microsoft.VisualBasic.dll.
NoWarnings Parameter Boolean opsional.

Jika true, tugas menekan semua peringatan. Untuk informasi selengkapnya, lihat -nowarn.
Optimize Parameter Boolean opsional.

Jika true, mengaktifkan pengoptimalan pengompilasi. Parameter ini sesuai dengan sakelar -optimize dari pengompilasi vbc.exe.
OptionCompare Parameter String opsional.

Menentukan bagaimana perbandingan string dibuat. Parameter ini dapat memiliki nilai berikut:

- binary
- text

Nilai binary menentukan bahwa tugas menggunakan perbandingan string biner. Nilai text menentukan bahwa tugas menggunakan perbandingan string teks. Nilai default dari parameter ini adalah binary. Parameter ini sesuai dengan sakelar -optioncompare dari pengompilasi vbc.exe.
OptionExplicit Parameter Boolean opsional.

Jika true, deklarasi eksplisit variabel diperlukan. Parameter ini sesuai dengan sakelar -optionexplicit dari pengompilasi vbc.exe.
OptionInfer Parameter Boolean opsional.

Jika true, memungkinkan inferensi jenis variabel.
OptionStrict Parameter Boolean opsional.

Jika true, tugas memberlakukan semantik jenis yang ketat untuk membatasi konversi jenis implisit. Parameter ini sesuai dengan sakelar -optionstrict dari pengompilasi vbc.exe.
OptionStrictType Parameter String opsional.

Menentukan semantik jenis ketat mana yang menghasilkan peringatan. Saat ini, hanya "kustom" yang didukung. Parameter ini sesuai dengan sakelar -optionstrict dari pengompilasi vbc.exe.
OutputAssembly Parameter output String opsional.

Menentukan nama file output. Parameter ini sesuai dengan sakelar -out pengompilasi vbc.exe.
Platform Parameter String opsional.

Menentukan platform prosesor yang akan ditargetkan oleh file output. Parameter ini dapat memiliki nilai x86, x64, Itanium, atau anycpu. Defaultnya adalah anycpu. Parameter ini sesuai dengan sakelar -platform pengompilasi vbc.exe.
References Parameter ITaskItem[] opsional.

Menyebabkan tugas mengimpor informasi jenis publik dari item yang ditentukan ke dalam proyek saat ini. Parameter ini sesuai dengan sakelar referensi pengompilasi vbc.exe.
RemoveIntegerChecks Parameter Boolean opsional.

Jika true, menonaktifkan pemeriksaan kesalahan luapan bilangan bulat. Nilai defaultnya adalah false. Parameter ini sesuai dengan sakelar -removeintchecks dari pengompilasi vbc.exe.
Resources Parameter ITaskItem[] opsional.

Menyematkan sumber daya .NET Framework ke dalam file output. Parameter ini sesuai dengan sakelar -resource pengompilasi vbc.exe.
ResponseFiles Parameter ITaskItem[] opsional.

Menentukan file respons yang berisi perintah untuk tugas ini. Parameter ini sesuai dengan opsi @ (Tentukan File Respons) dari pengompilasi vbc.exe.
RootNamespace Parameter String opsional.

Menentukan namespace layanan akar untuk semua deklarasi jenis. Parameter ini sesuai dengan sakelar -rootnamespace dari pengompilasi vbc.exe.
SdkPath Parameter String opsional.

Menentukan lokasi mscorlib.dll dan microsoft.visualbasic.dll. Parameter ini sesuai dengan sakelar -sdkpath dari pengompilasi vbc.exe.
Sources Parameter ITaskItem[] opsional.

Menentukan satu atau beberapa file sumber Visual Basic.
TargetCompactFramework Parameter Boolean opsional.

Jika true, tugas menargetkan .NET Compact Framework. Sakelar ini sesuai dengan sakelar -netcf dari pengompilasi vbc.exe.
TargetType Parameter String opsional.

Menentukan format file dari file output. Parameter ini dapat memiliki nilai library, yang membuat pustaka kode, exe, yang membuat aplikasi konsol, module, yang membuat modul, atau winexe, yang membuat program Windows. Defaultnya adalah library. Parameter ini sesuai dengan sakelar -target pengompilasi vbc.exe.
Timeout Parameter Int32 opsional.

Menentukan jumlah waktu, dalam milidetik, yang setelahnya tugas yang dapat dieksekusi dihentikan. Nilai defaultnya adalah Int.MaxValue, menunjukkan bahwa tidak ada periode waktu habis.
ToolPath Parameter String opsional.

Menentukan lokasi dari mana tugas akan memuat file yang dapat dieksekusi yang mendasar (vbc.exe). Jika parameter ini tidak ditentukan, tugas akan menggunakan jalur penginstalan SDK yang sesuai dengan versi kerangka kerja yang menjalankan MSBuild.
TreatWarningsAsErrors Parameter Boolean opsional.

Jika true, semua peringatan diperlakukan sebagai kesalahan. Untuk informasi selengkapnya, lihat -warnaserror (Visual Basic).
UseHostCompilerIfAvailable Parameter Boolean opsional.

Menginstruksikan tugas untuk menggunakan objek pengompilasi dalam proses, jika tersedia. Hanya digunakan oleh Visual Studio.
Utf8Output Parameter Boolean opsional.

Mencatat output pengompilasi menggunakan pengodean UTF-8. Parameter ini sesuai dengan sakelar -utf8output dari pengompilasi vbc.exe.
Verbosity Parameter String opsional.

Menentukan verbositas output pengompilasi. Verbositas dapat berupa Quiet, Normal (default), atau Verbose.
WarningsAsErrors Parameter String opsional.

Menentukan daftar peringatan yang diperlakukan sebagai kesalahan. Untuk informasi selengkapnya, lihat -warnaserror (Visual Basic).

Parameter ini mengambil alih parameter TreatWarningsAsErrors.
WarningsNotAsErrors Parameter String opsional.

Menentukan daftar peringatan yang tidak diperlakukan sebagai kesalahan. Untuk informasi selengkapnya, lihat -warnaserror (Visual Basic).

Parameter ini hanya relevan jika parameter TreatWarningsAsErrors diatur ke true.
Win32Icon Parameter String opsional.

Menyisipkan file .ico di assembly, yang memberikan file output tampilan yang diinginkan dalam File Explorer. Parameter ini sesuai dengan sakelar -win32icon dari pengkompilasi vbc.exe.
Win32Resources Parameter String opsional.

Menyisipkan file sumber daya Win32 (.res) dalam file output. Parameter ini sesuai dengan sakelar -win32resource dari pengompilasi vbc.exe.

Parameter ToolTaskExtension

Tugas ini mewarisi dari kelas ToolTaskExtension, yang mewarisi dari kelas ToolTask, yang mewarisi dari Task kelas itu sendiri. Rantai pewarisan ini menambahkan beberapa parameter ke tugas yang berasal dari tugas itu sendiri.

Tabel berikut ini menjelaskan parameter kelas dasar:

Parameter Deskripsi
EchoOff Parameter bool opsional.

Ketika diatur ke true, tugas ini meneruskan /Q ke baris perintahcmd.exe, sehingga baris perintah tidak disalin ke stdout.
EnvironmentVariables Parameter array String opsional.

Array definisi variabel lingkungan, dipisahkan oleh titik koma. Setiap definisi harus menentukan nama dan nilai variabel lingkungan yang dipisahkan oleh tanda sama dengan. Variabel-variabel ini diteruskan ke yang dapat dijalankan yang dihasilkan selain, atau secara selektif mengambil alih, blok lingkungan reguler. Misalnya, Variable1=Value1;Variable2=Value2.
ExitCode Parameter baca-saja output Int32 opsional.

Tentukan kode keluar yang disediakan oleh perintah yang dijalankan. Jika tugas mencatat kesalahan apa pun, tetapi prosesnya memiliki kode keluar 0 (berhasil), ini diatur ke -1.
LogStandardErrorAsError Parameter bool opsional.

Jika true, semua pesan yang diterima pada aliran kesalahan standar dicatat sebagai kesalahan.
StandardErrorImportance Parameter String opsional.

Pentingnya untuk mencatat teks dari aliran kesalahan standar.
StandardOutputImportance Parameter String opsional.

Pentingnya untuk mencatat teks dari aliran keluar standar.
Timeout Parameter Int32 opsional.

Menentukan jumlah waktu, dalam milidetik, yang setelahnya tugas yang dapat dieksekusi dihentikan. Nilai defaultnya adalah Int.MaxValue, menunjukkan bahwa tidak ada periode waktu habis. Waktu habis dalam milidetik.
ToolExe Parameter string opsional.

Proyek dapat menerapkan ini untuk mengambil alih ToolName. Tugas dapat mengambil alih ini untuk mempertahankan ToolName.
ToolPath Parameter string opsional.

Tentukan lokasi dari mana tugas memuat file eksekusi yang mendasarinya. Jika parameter ini tidak ditentukan, tugas menggunakan jalur penginstalan SDK yang sesuai dengan versi kerangka kerja yang menjalankan MSBuild.
UseCommandProcessor Parameter bool opsional.

Saat diatur ke true, tugas ini membuat file batch untuk baris perintah dan menjalankannya dengan menggunakan prosesor perintah alih-alih menjalankan perintah secara langsung.
YieldDuringToolExecution Parameter bool opsional.

Saat diatur ke true, tugas ini menghasilkan node saat tugasnya dijalankan.

Contoh

Contoh berikut mengompilasi proyek Visual Basic.

<VBC
   Sources="@(sources)"
   Resources="strings.resources"
   Optimize="true"
   OutputAssembly="out.exe"/>

Baca juga