Bagikan melalui


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; symbol2

Visual Basic: symbol1 = value1, symbol2 = value2

Properti 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.
GenerateDocumentationFile .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.

Lihat juga