Tugas Vbc
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: simbol1 = nilai1 ; simbol2 = nilai2Parameter 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. Contohnya, 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"/>