Properti proyek MSBuild umum
Tabel berikut mencantumkan properti yang sering digunakan yang ditentukan dalam file proyek Visual Studio atau disertakan dalam file .targets yang disediakan MSBuild.
File proyek di Visual Studio (.csproj, .vbproj, .vcxproj, dan lainnya) berisi kode XML MSBuild yang berjalan saat Anda membuat proyek dengan menggunakan IDE. Proyek biasanya mengimpor satu atau beberapa file .targets untuk menentukan proses pembuatannya. Untuk informasi lebih lanjut, lihat MSBuild .targets files.
Saat mengatur nilai properti, perlu diingat bahwa properti umum dapat diatur, diatur ulang, atau digunakan dalam sejumlah file yang diimpor. Oleh karena itu, penting di mana Anda mengatur properti --dalam file proyek Anda, di Directory.Build.props, atau dalam file impor lainnya. Jika Anda mengatur properti di suatu tempat dan tidak mendapatkan hasil yang diharapkan, pertimbangkan di mana dan bagaimana properti diubah atau digunakan dalam semua file yang diimpor oleh proyek Anda, termasuk impor yang ditambahkan secara implisit saat Anda menggunakan Sdk atribut . Lihat Memilih antara menambahkan properti ke file .props atau .targets. Pra-pemrosesan dapat membantu dengan ini (lihat /preprocess opsi baris perintah atau /pp di referensi baris perintah MSBuild).
Daftar properti dan parameter umum
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| AdditionalLibPaths | .NET | Menentukan folder tambahan di mana kompiler harus mencari rakitan referensi. |
| AddModules | .NET | Menyebabkan pengkompilasi membuat semua informasi jenis dari file yang ditentukan tersedia untuk proyek yang Anda kompilasi. Properti ini setara dengan sakelar kompiler /addModules. |
| ALToolPath | .NET | Jalur ke AL.exe. Properti ini menggantikan versi AL.exe saat ini untuk memungkinkan penggunaan versi yang berbeda. |
| ApplicationIcon | .NET | File ikon .ico akan diteruskan ke kompiler untuk disematkan sebagai ikon Win32. Properti ini setara dengan sakelar kompiler /win32icon. |
| ApplicationManifest | Semua | Menentukan jalur file yang digunakan untuk menghasilkan informasi manifes User Account Control (UAC) eksternal. Hanya berlaku untuk proyek Visual Studio yang menargetkan Windows Vista. Dalam kebanyakan kasus, manifes disematkan. Namun, jika Anda menggunakan Pendaftaran COM Gratis atau penyebaran ClickOnce, maka manifes dapat berupa file eksternal yang diinstal bersama dengan rakitan aplikasi Anda. Untuk informasi selengkapnya, lihat properti NoWin32Manifest di artikel ini. |
| AssemblyOriginatorKeyFile | .NET | Menentukan file yang digunakan untuk menandatangani rakitan (.snk atau .pfx) dan yang diteruskan ke tugas ResolveKeySource untuk menghasilkan kunci aktual yang digunakan untuk menandatangani rakitan. |
| AssemblySearchPaths | .NET | Daftar lokasi yang akan dicari selama resolusi perakitan referensi waktu build. Urutan di mana jalur muncul dalam daftar ini bermakna karena jalur yang tercantum sebelumnya lebih diutamakan daripada entri selanjutnya. |
| AssemblyName | .NET | Nama perakitan hasil akhir setelah proyek dibangun. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| BaseAddress | .NET | Menentukan alamat dasar dari rakitan output utama. Properti ini setara dengan sakelar kompiler /baseaddress. |
| BaseIntermediateOutputPath | Semua | Folder tingkat atas tempat semua folder output perantara khusus konfigurasi dibuat. Nilai defaultnya adalah obj\. Kode berikut adalah contohnya: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
| BaseOutputPath | Semua | Menentukan jalur dasar untuk file output. Jika diatur, MSBuild menggunakan OutputPath = $(BaseOutputPath)\$(Configuration)\. Contoh sintaksis: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
| BuildInParallel | Semua | Nilai boolean yang menunjukkan apakah referensi proyek dibuat atau dibersihkan secara paralel saat Multi-Proc MSBuild digunakan. Nilai defaultnya adalah true, yang berarti bahwa proyek akan dibangun secara paralel jika sistem memiliki beberapa inti atau prosesor. |
| BuildProjectReferences | Semua | Nilai boolean yang menunjukkan apakah referensi proyek dibangun oleh MSBuild. Secara otomatis diatur ke false jika Anda membangun proyek di lingkungan pengembangan terintegrasi Visual Studio (IDE), true jika sebaliknya. -p:BuildProjectReferences=falsedapat ditentukan pada baris perintah untuk menghindari pemeriksaan bahwa proyek yang dirujuk adalah yang terbaru. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| CleanFile | Semua | Nama file yang akan digunakan sebagai "pembersihan cache". Pembersihan cache adalah daftar file yang dihasilkan untuk dihapus selama operasi pembersihan. File dimasukkan di jalur output perantara oleh proses build. Properti ini hanya menentukan nama file yang tidak memiliki informasi jalur. |
| CodePage | .NET | Menentukan halaman kode yang akan digunakan untuk semua file kode sumber di dalam kompilasi. Properti ini setara dengan sakelar kompiler /codepage. |
| CompilerResponseFile | .NET | File respons opsional yang dapat diteruskan ke tugas kompiler. |
| Konfigurasi | Semua | Konfigurasi yang Anda bangun, umumnya Debug atau Release, tetapi dapat dikonfigurasi pada tingkat solusi dan proyek. |
| CscToolPath | C# | Jalur csc.exe, kompiler C#. |
| CustomAfterMicrosoftCommonTargets | Semua | Nama file proyek atau file target yang akan diimpor secara otomatis setelah target umum diimpor. |
| CustomBeforeMicrosoftCommonTargets | Semua | Nama file proyek atau file target yang akan diimpor secara otomatis sebelum target umum diimpor. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| DebugSymbols | Semua | Nilai boolean yang menunjukkan apakah simbol dihasilkan oleh build. Mengatur -p:DebugSymbols=false pada baris perintah akan menonaktifkan pembuatan file simbol database program (.pdb). |
| DebugType | Semua | Menentukan tingkat informasi debug yang ingin Anda buat. Nilai yang valid adalah "full", "pdbonly", "portabel", "tersemat", dan "tidak ada". |
| DefineConstants | .NET | Menentukan konstanta pengkompilasi kondisional. Pasangan simbol/nilai dipisahkan oleh titik koma dan ditentukan dengan menggunakan sintaksis dependen bahasa: C#: symbol1; symbol2Visual Basic: symbol1 = value1, symbol2 = value2Properti ini setara dengan sakelar kompiler /define. |
| DefineDebug | Semua | Nilai boolean yang menunjukkan apakah Anda ingin konstanta DEBUG ditentukan. |
| DefineTrace | Semua | Nilai boolean yang menunjukkan apakah Anda ingin konstanta TRACE ditentukan. |
| DelaySign | .NET | Nilai boolean yang menunjukkan apakah Anda ingin menunda-menandatangani rakitan daripada menandatangani penuh. |
| Deterministic | .NET | Nilai boolean yang menunjukkan apakah kompiler harus menghasilkan rakitan identik untuk input yang identik. Parameter ini sesuai dengan sakelar /deterministic dari kompiler. |
| DirectoryBuildPropsPath | Semua | Menentukan jalur ke file Directory.Build.props ; jika ditentukan, properti ini mengambil alih algoritma pencarian default. Lihat Menkustomisasi build Anda. |
| DirectoryBuildTargetsPath | Semua | Menentukan jalur ke file Directory.Build.targets ; jika ditentukan, properti ini mengambil alih algoritma pencarian default. Lihat Menkustomisasi build Anda. |
| DisableFastUpToDateCheck | Semua | Nilai boolean yang hanya berlaku untuk Visual Studio. Manajer build Visual Studio menggunakan proses yang disebut FastUpToDateCheck untuk menentukan apakah proyek harus dibuat ulang agar diperbarui. Proses ini lebih cepat daripada menggunakan MSBuild untuk menentukan ini. Mengatur properti DisableFastUpToDateCheck ke true memungkinkan Anda melewati manajer build Visual Studio dan memaksanya menggunakan MSBuild untuk menentukan apakah proyek sudah diperbarui. |
| DocumentationFile | .NET | Nama file yang dihasilkan sebagai file dokumentasi XML. Nama ini hanya menyertakan nama file dan tidak memiliki informasi jalur. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| ErrorReport | .NET | Menentukan bagaimana tugas kompiler harus melaporkan kesalahan kompiler internal. Nilai yang valid adalah "prompt", "send", atau "none". Properti ini setara dengan sakelar kompiler /errorreport. |
| ExcludeDeploymentUrl | .NET | Tugas GenerateDeploymentManifest menambahkan tag deploymentProvider ke manifes penyebaran jika file proyek menyertakan salah satu elemen berikut: - UpdateUrl - InstallUrl - PublishUrl Namun, dengan menggunakan ExcludeDeploymentUrl, Anda dapat mencegah tag deploymentProvider ditambahkan ke manifes penyebaran meskipun salah satu URL di atas telah ditentukan. Untuk melakukannya, tambahkan properti berikut ke file proyek Anda: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Catatan: ExcludeDeploymentUrl tidak diekspos di VISUAL Studio IDE dan hanya dapat diatur dengan mengedit file proyek secara manual. Mengatur properti ini tidak memengaruhi penerbitan dalam Visual Studio; artinya, tag deploymentProvider masih akan ditambahkan ke URL yang ditentukan oleh PublishUrl. |
| FileAlignment | .NET | Menentukan, dalam byte, tempat untuk menyelaraskan bagian dari file output. Nilai yang valid adalah 512, 1024, 2048, 4096, 8192. Properti ini setara dengan sakelar kompiler /filealignment. |
| FrameworkPathOverride | Visual Basic | Menentukan lokasi mscorlib.dll dan microsoft.visualbasic.dll. Parameter ini setara dengan sakelar /sdkpath dari kompiler vbc.exe. |
| GenerateDocumentation | .NET | Parameter boolean yang menunjukkan apakah dokumentasi dihasilkan oleh build. Jika true, build menghasilkan informasi dokumentasi dan menempatkannya dalam file .xml bersama dengan nama file atau pustaka yang dapat dijalankan yang dibuat oleh tugas build. |
| GenerateFullPaths | C# | Hasilkan jalur lengkap untuk nama file dalam output dengan menggunakan opsi kompiler -fullpaths. |
| GenerateSerializationAssemblies | .NET | Menunjukkan apakah rakitan serialisasi XML harus dibuat oleh SGen.exe, yang dapat diatur ke aktif, otomatis, atau nonaktif. Properti ini digunakan untuk rakitan yang hanya menargetkan .NET Framework. Untuk menghasilkan rakitan serialisasi XML untuk rakitan .NET Standard atau .NET Core, referensikan paket NuGet Microsoft.XmlSerializer.Generator. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| ImportDirectoryBuildProps | Semua | Nilai boolean yang menunjukkan apakah akan mengimpor file Directory.Build.props . Lihat Menkustomisasi build Anda. |
| ImportDirectoryBuildTargets | Semua | Nilai boolean yang menunjukkan apakah akan mengimpor file Directory.Build.targets . Lihat Menkustomisasi build Anda. |
| IntermediateOutputPath | Semua | Jalur output perantara penuh seperti yang diturunkan dari BaseIntermediateOutputPath, jika tidak ada jalur yang ditentukan. Misalnya, obj\debug\. |
| KeyContainerName | Semua | Nama kontainer kunci dengan nama yang kuat. |
| KeyOriginatorFile | Semua | Nama file kunci dengan nama yang kuat. |
| ModuleAssemblyName | .NET | Nama rakitan tempat modul yang dikompilasi akan dimasukkan. Properti ini setara dengan sakelar kompiler /moduleassemblyname. |
| MSBuildProjectExtensionsPath | Semua | Menentukan jalur tempat ekstensi proyek berada. Secara default, ini mengambil nilai yang sama dengan BaseIntermediateOutputPath. |
| MSBuildTreatWarningsAsErrors | Semua | Nilai boolean yang memberi tahu MSBuild untuk memperlakukan semua peringatan sebagai kesalahan, kecuali jika disembunyikan. |
| MSBuildWarningsAsErrors | Semua | Menentukan daftar kode peringatan untuk diperlakukan sebagai kesalahan. Pisahkan beberapa peringatan dengan titik koma. Jika Anda menggunakan properti WarningsAsErrors.NET SDK , MSBuildWarningsAsErrors akan default ke nilai WarningsAsErrors. |
| MSBuildWarningsAsMessages | Semua | Menentukan daftar kode peringatan untuk ditekan dengan memperlakukannya sebagai pesan yang tidak terlalu penting. Pisahkan beberapa peringatan dengan titik koma. Perhatikan bahwa beberapa peringatan yang dipancarkan oleh MSBuild tidak dapat ditekan dengan menggunakan properti ini; untuk menekannya, gunakan sakelar -warnAsMessagebaris perintah . Jika Anda menggunakan properti NoWarn.NET SDK , MSBuildWarningsAsMessages akan default ke nilai NoWarn. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| NoLogo | Semua | Nilai boolean yang menunjukkan apakah Anda ingin logo kompiler dimatikan. Properti ini setara dengan sakelar kompiler /nologo. |
| NoStdLib | .NET | Nilai boolean yang menunjukkan apakah akan menghindari referensi pustaka standar (mscorlib.dll). Nilai defaultnya adalah false. |
| NoVBRuntimeReference | Visual Basic | Nilai boolean yang menunjukkan apakah runtime Visual Basic (Microsoft.VisualBasic.dll) harus disertakan sebagai referensi dalam proyek. |
| NoWarn | .NET | Menekan peringatan yang ditentukan. Hanya bagian numerik dari pengidentifikasi peringatan yang harus ditentukan. Beberapa peringatan dipisahkan oleh titik koma. Parameter ini sesuai dengan sakelar /nowarn dari kompiler. |
| -NoWin32Manifest | .NET | Nilai boolean yang menunjukkan apakah informasi manifes User Account Control (UAC) akan disematkan dalam aplikasi yang dapat dijalankan. Hanya berlaku untuk proyek Visual Studio yang menargetkan Windows Vista. Dalam proyek yang disebarkan menggunakan ClickOnce dan egistration-Free COM, elemen ini diabaikan. False (nilai default) menetapkan bahwa informasi manifes User Account Control (UAC) disematkan dalam aplikasi yang dapat dijalankan. True menetapkan bahwa informasi manifes UAC tidak disematkan.Properti ini hanya berlaku untuk proyek Visual Studio yang menargetkan Windows Vista. Dalam proyek yang disebarkan menggunakan ClickOnce dan Registration-Free COM, properti ini diabaikan. Anda harus menambahkan NoWin32Manifest hanya jika Anda tidak ingin Visual Studio menyematkan informasi manifes apa pun dalam aplikasi yang dapat dieksekusi; proses ini disebut virtualisasi. Untuk menggunakan virtualisasi, atur <ApplicationManifest> bersama dengan <NoWin32Manifest> sebagai berikut:- Untuk proyek Visual Basic, hapus node <ApplicationManifest>. (Dalam proyek Visual Basic, <NoWin32Manifest> diabaikan bila ada node <ApplicationManifest>.)- Untuk proyek C#, atur <ApplicationManifest> ke False dan <NoWin32Manifest> ke True. (Dalam proyek C#, <ApplicationManifest> ambil alih <NoWin32Manifest>.)Properti ini setara dengan /nowin32manifest sakelar kompiler vbc.exe. |
| Optimalkan | .NET | Nilai boolean yang bila diatur ke true, memungkinkan pengoptimalan kompiler. Properti ini setara dengan sakelar kompiler /optimize. |
| OptionCompare | VisualBasic | Menentukan bagaimana perbandingan string dibuat. Nilai yang valid adalah "biner" atau "teks". Properti ini setara dengan /optioncompare sakelar kompiler vbc.exe. |
| OptionExplicit | Visual Basic | Nilai boolean yang bila diatur ke true, memerlukan deklarasi variabel yang eksplisit dalam kode sumber. Properti ini setara dengan sakelar kompiler /optionexplicit. |
| OptionInfer | Visual Basic | Nilai boolean yang ketika diatur ke true, memungkinkan inferensi jenis variabel. Properti ini setara dengan sakelar kompiler /optioninfer. |
| OptionStrict | Visual Basic | Nilai boolean yang ketika diatur ke true, menyebabkan tugas build menerapkan semantik jenis yang ketat untuk membatasi konversi jenis implisit. Properti ini setara dengan /optionstrict sakelar kompiler vbc.exe. |
| OutDir | Semua | Menunjukkan lokasi output akhir untuk proyek atau solusi. Saat membangun solusi, OutDir dapat digunakan untuk mengumpulkan beberapa output proyek di satu lokasi. Selain itu, OutDir disertakan dalam AssemblySearchPaths yang digunakan untuk menyelesaikan referensi. Misalnya, bin\Debug. |
| OutputPath | Semua | Menentukan jalur ke direktori output, relatif terhadap direktori proyek, misalnya, bin\Debug atau bin\Debug\$(Platform) dalam build non-AnyCPU. |
| OutputType | Semua | Menentukan format file dari file output. Parameter ini dapat memiliki salah satu nilai berikut: - Pustaka. Membuat pustaka kode. (Nilai default.) - Exe. Membuat aplikasi konsol. - Modul. Membuat modul. - Winexe. Membuat program berbasis Windows. Untuk C# dan Visual Basic, properti ini setara dengan sakelar /target. Jenis output dapat secara otomatis diganti dengan inferensi. Lihat OutputType diatur ke WinExe untuk aplikasi WPF dan WinForms. Nonaktifkan inferensi dengan mengatur DisableWinExeOutputInference ke true. |
| OverwriteReadOnlyFiles | Semua | Nilai boolean yang menunjukkan apakah Anda ingin mengaktifkan build untuk mengganti file hanya-baca atau memicu kesalahan. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| PathMap | .NET | Menentukan cara memetakan jalur fisik ke output nama jalur sumber oleh kompiler. Properti ini setara dengan /pathmap sakelar kompiler. |
| PdbFile | .NET | Nama file file .pdb yang Anda keluarkan. Properti ini setara dengan /pdb sakelar kompiler csc.exe. |
| Platform | Semua | Sistem operasi yang Anda bangun. Contoh untuk build .NET Framework adalah "CPU apa saja", "x86", dan "x64". |
| ProcessorArchitecture | .NET | Arsitektur prosesor yang digunakan saat referensi perakitan diselesaikan. Nilai yang valid adalah "msil", "x86", "amd64", atau "ia64". |
| ProduceOnlyReferenceAssembly | .NET | Nilai boolean yang menginstruksikan kompiler untuk hanya memancarkan rakitan referensi daripada kode yang dikompilasi. Tidak dapat digunakan bersama dengan ProduceReferenceAssembly. Properti ini sesuai dengan /refonly sakelar kompiler vbc.exe dan csc.exe. |
| ProduceReferenceAssembly | .NET | Nilai boolean yang ketika diatur ke true memungkinkan produksi rakitan referensi untuk rakitan saat ini. Deterministic harus true saat menggunakan fitur ini. Properti ini sesuai dengan /refout sakelar kompiler vbc.exe dan csc.exe. |
| RegisterAssemblyMSBuildArchitecture | Hanya Windows | Menentukan arsitektur default tempat DLL terkelola didaftarkan. Properti ini berguna karena COM menggunakan registri Windows untuk menyimpan pendaftaran di sarang khusus arsitektur. Misalnya, pada sistem Windows, rakitan yang dikelola AnyCPU dapat memiliki jenisnya yang terdaftar di sarang 64-bit dan/atau di sarang 32-bit (WoW), dan build menggunakan properti ini untuk menentukan sarang registri khusus arsitektur mana yang akan digunakan. Nilai yang valid termasuk "x86," "x64," dan "ARM64." |
| RegisterForCOMInterop | Hanya Windows | Menunjukkan bahwa aplikasi terkelola Anda akan mengekspos objek COM (pembungkus yang dapat dipanggil COM). Lihat halaman Build - Bagian output. Pengaturan ini hanya memengaruhi komputer tempat proyek dibangun. Jika Anda menyebarkan ke komputer lain, panggil regasm.exe untuk mendaftarkan assembly pada komputer target. |
| RemoveIntegerChecks | Visual Basic | Nilai boolean yang menunjukkan apakah akan menonaktifkan pemeriksaan kesalahan luapan bilangan bulat. Nilai defaultnya adalah false. Properti ini setara dengan /removeintchecks sakelar kompiler vbc.exe. |
| RootNamespace | Semua | Namespace layanan akar yang akan digunakan saat Anda memberi nama sumber daya yang disematkan. Namespace layanan ini adalah bagian dari nama manifes sumber daya yang disematkan. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| Satellite_AlgorithmId | .NET | ID algoritme hashing AL.exe yang akan digunakan saat rakitan satelit dibuat. |
| Satellite_BaseAddress | .NET | Alamat dasar yang digunakan saat rakitan satelit khusus budaya dibangun dengan menggunakan target CreateSatelliteAssemblies. |
| Satellite_CompanyName | .NET | Nama perusahaan yang akan diteruskan ke AL.exe selama pembuatan perakitan satelit. |
| Satellite_Configuration | .NET | Nama konfigurasi yang akan diteruskan ke AL.exe selama pembuatan rakitan satelit. |
| Satellite_Description | .NET | Teks deskripsi untuk diteruskan ke AL.exe selama pembuatan perakitan satelit. |
| Satellite_EvidenceFile | .NET | Menyematkan file yang ditentukan dalam rakitan satelit yang memiliki nama sumber daya "Security.Evidence." |
| Satellite_FileVersion | .NET | Menentukan string untuk bidang Versi File di rakitan satelit. |
| Satellite_Flags | .NET | Menentukan nilai untuk bidang Tanda di rakitan satelit. |
| Satellite_GenerateFullPaths | .NET | Menyebabkan tugas build menggunakan jalur absolut untuk file apa pun yang dilaporkan dalam pesan galat. |
| Satellite_LinkResource | .NET | Menautkan file sumber daya yang ditentukan ke rakitan satelit. |
| Satellite_MainEntryPoint | .NET | Menentukan nama yang sepenuhnya memenuhi syarat (yaitu, class.method) dari metode yang akan digunakan sebagai titik masuk ketika modul dikonversi ke file yang dapat dijalankan selama pembuatan rakitan satelit. |
| Satellite_ProductName | .NET | Menentukan string untuk bidang Produk di rakitan satelit. |
| Satellite_ProductVersion | .NET | Menentukan string untuk bidang ProductVersion di rakitan satelit. |
| Satellite_TargetType | .NET | Menentukan format file dari file output rakitan satelit sebagai "library," "exe," atau "win." Nilai defaultnya adalah "library." |
| Satellite_Title | .NET | Menentukan string untuk bidang Judul di rakitan satelit. |
| Satellite_Trademark | .NET | Menentukan string untuk bidang Merek Dagang di rakitan satelit. |
| Satellite_Version | .NET | Menentukan informasi versi untuk perakitan satelit. |
| Satellite_Win32Icon | .NET | Menyisipkan file ikon .ico di rakitan satelit. |
| Satellite_Win32Resource | .NET | Menyisipkan sumber daya Win32 (file .res) ke dalam rakitan satelit. |
| SGenToolPath | .NET | Jalur alat opsional yang menunjukkan tempat untuk mendapatkan SGen.exe saat versi SGen.exe saat ini diganti. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| SGenUseProxyTypes | .NET | Nilai boolean yang menunjukkan apakah jenis proksi harus dibuat oleh SGen.exe. Ini hanya berlaku jika GenerateSerializationAssemblies diaktifkan. Target SGen menggunakan properti ini untuk mengatur tanda UseProxyTypes. Properti ini default ke true, dan tidak ada UI untuk mengubah ini. Untuk menghasilkan rakitan serialisasi untuk jenis non-layanan web, tambahkan properti ini ke file proyek dan atur ke false sebelum mengimpor Microsoft.Common.Targets atau C#/VB.targets. |
| SkipInvalidConfigurations | Semua | Ketika true, menghasilkan peringatan pada kombinasi platform dan konfigurasi yang tidak valid, tetapi jangan gagal membangun; ketika false atau tidak terdefinisi (default), menghasilkan kesalahan. |
| StartupObject | .NET | Menentukan kelas atau modul yang berisi metode Utama atau prosedur Sub Utama. Properti ini setara dengan sakelar kompiler /main. |
| SubsystemVersion | .NET | Menentukan versi minimum subsistem yang dapat digunakan oleh file executable yang dihasilkan. Properti ini setara dengan sakelar kompiler /subsystemversion. Untuk informasi tentang nilai default properti ini, lihat /subsystemversion (Visual Basic) atau /subsystemversion (opsi kompiler C#). |
| TargetCompactFramework | .NET | Versi .NET Compact Framework yang diperlukan untuk menjalankan aplikasi yang Sedang Anda bangun. Menentukan ini memungkinkan Anda mereferensikan rakitan kerangka kerja tertentu yang mungkin tidak dapat Anda referensikan sebaliknya. |
| TargetFrameworkVersion | .NET | Versi .NET Framework yang diperlukan untuk menjalankan aplikasi yang Sedang Anda bangun. Menentukan ini memungkinkan Anda mereferensikan rakitan kerangka kerja tertentu yang mungkin tidak dapat Anda referensikan sebaliknya. |
| TreatWarningsAsErrors | .NET | Parameter boolean yang, jika true, menyebabkan semua peringatan diperlakukan sebagai kesalahan. Parameter ini setara dengan sakelar kompiler /nowarn. |
| UseCommonOutputDirectory | .NET | Properti boolean yang dapat Anda atur ke true saat Anda ingin semua output build dalam solusi untuk menggunakan direktori output yang sama. Jika true, output proyek yang direferensikan tidak disalin ke proyek yang menggunakan dependensi tersebut, seperti biasanya ketika pengaturan ini adalah false. Mengatur parameter ini agar true tidak mengubah direktori output aktual dari proyek apa pun; Anda masih perlu mengatur direktori output ke direktori output umum yang diinginkan untuk setiap proyek yang memerlukannya. |
| UseHostCompilerIfAvailable | .NET | Parameter boolean yang, jika true, menyebabkan tugas build menggunakan objek kompilator dalam proses, jika tersedia. Parameter ini hanya digunakan oleh Visual Studio. |
| Utf8Output | .NET | Parameter boolean yang, jika true, mencatat output kompiler dengan menggunakan pengkodean UTF-8. Parameter ini setara dengan sakelar kompiler /utf8Output. |
| Nama properti atau parameter | Jenis proyek | Deskripsi |
|---|---|---|
| VbcToolPath | Visual Basic | Jalur opsional yang menunjukkan lokasi lain untuk vbc.exe saat versi vbc.exe saat ini diganti. |
| VbcVerbosity | Visual Basic | Menentukan verbositas output kompiler Visual Basic. Nilai yang valid adalah "Diam", "Normal" (nilai default), atau "Verbose". |
| VisualStudioVersion | Semua | Menentukan versi Visual Studio di mana proyek ini harus dianggap berjalan. Jika properti ini tidak ditentukan, MSBuild mengaturnya ke nilai default {VisualStudioMajorVersion}.0; misalnya itu akan menjadi 17.0 untuk semua versi Visual Studio 2022.Properti ini digunakan dalam beberapa jenis proyek untuk menentukan kumpulan target yang digunakan untuk build. Jika ToolsVersion diatur ke 4.0 atau yang lebih tinggi untuk sebuah proyek, VisualStudioVersion digunakan untuk menentukan sub-toolset yang akan digunakan. Untuk informasi lebih lanjut, lihat Toolset (ToolsVersion). |
| WarningsAsErrors | .NET | Menentukan daftar peringatan yang diperlakukan sebagai kesalahan. Parameter ini setara dengan sakelar kompiler /warnaserror. |
| WarningLevel | Semua | Menentukan tingkat peringatan yang akan diteruskan ke kompiler untuk peringatan yang dipancarkan oleh kompiler. Pengaturan ini tidak memengaruhi peringatan MSBuild, yang tidak memiliki penetapan tingkat. Lihat Tingkat Peringatan dalam dokumentasi kompiler C# dan /W (Tingkat Peringatan) dalam dokumentasi kompiler C++. |
| WarningsNotAsErrors | .NET | Menentukan daftar peringatan yang tidak diperlakukan sebagai kesalahan. Parameter ini setara dengan sakelar kompiler /warnaserror. |
| Win32Manifest | .NET | Nama file manifes yang harus disematkan di perakitan akhir. Parameter ini setara dengan sakelar kompiler /win32Manifest. |
| Win32Resource | .NET | Nama file sumber daya Win32 yang akan disematkan di perakitan akhir. Parameter ini setara dengan sakelar kompiler /win32resource. |
Properti khusus untuk proyek .NET SDK, seperti TargetFramework, didokumentasikan di Properti Kerangka kerja.
Baca juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk