Properti yang dicadangkan dan terkenal MSBuild

MSBuild menyediakan sekumpulan properti yang telah ditentukan sebelumnya yang menyimpan informasi tentang file proyek dan biner MSBuild. Properti ini dievaluasi dengan cara yang sama seperti properti MSBuild lainnya. Misalnya, untuk menggunakan properti MSBuildProjectFile, Anda mengetik $(MSBuildProjectFile).

MSBuild menggunakan nilai dalam tabel berikut untuk menentukan properti yang dicadangkan dan populer. Properti yang dipesan tidak dapat ditimpa, dan properti yang paling terkenal tidak boleh ditimpa kecuali dalam skenario lanjutan.

Properti yang dicadangkan dan populer

Tabel di bagian ini memperlihatkan properti MSBuild yang telah ditentukan sebelumnya. Kolom contoh dalam tabel berkaitan dengan contoh file proyek berikut, diasumsikan terletak di C:\Source\Repos\ConsoleApp1\ConsoleApp1, dan menunjukkan contoh nilai yang dimiliki properti ini saat diakses dalam file proyek, ketika MSBuild dipanggil tanpa opsi baris perintah khusus.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>
</Project>

Properti	Dicadangkan atau populer	Deskripsi	Contoh
FrameworkSDKRoot	Populer	Jalur ke folder akar untuk alat .NET Framework.	C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\
InnerBuildProperty	Populer	Menentukan nama properti yang menentukan dimensi build multitargeting (hanya berlaku jika build saat ini adalah build grafik).	TargetFramework
InnerBuildPropertyValues	Populer	Menentukan nama properti yang menyimpan nilai yang mungkin untuk InnerBuildProperty (hanya berlaku jika build saat ini adalah build grafik).	TargetFrameworks
IsGraphBuild	Populer	True jika ini adalah build grafik; yaitu, -graphBuild opsi berlaku. Opsi ini berarti MSBuild membangun dan membangun grafik proyek. Penyusunan grafik melibatkan identifikasi referensi proyek untuk membentuk dependensi. Pembangunan grafik tersebut melibatkan upaya pembangunan referensi proyek sebelum pembangunan proyek yang menggunakannya sebagai referensi, berbeda dengan penjadwalan MSBuild tradisional.
MSBuildAssemblyVersion	Dicadangkan	Versi rakitan MSBuild yang digunakan untuk membangun proyek.	17,0
MSBuildBinPath	Dicadangkan	Jalur absolut folder tempat biner MSBuild yang saat ini digunakan berada (misalnya, C:\Windows\Microsoft.Net\Framework\<versionNumber>). Properti ini berguna jika Anda harus merujuk ke file di direktori MSBuild. Jangan sertakan garis miring terbalik terakhir pada properti ini.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildDisableFeaturesFromVersion	Dicadangkan	Digunakan oleh MSBuild dan Microsoft SDK untuk mengelola gelombang perubahan.
MSBuildExtensionsPath	Populer	Diperkenalkan dalam .NET Framework 4: tidak ada perbedaan antara nilai MSBuildExtensionsPath default dan MSBuildExtensionsPath32. Anda dapat mengatur variabel MSBUILDLEGACYEXTENSIONSPATH lingkungan ke nilai non-null untuk mengaktifkan perilaku nilai default MSBuildExtensionsPath dalam versi sebelumnya. Di .NET Framework 3.5 dan yang lebih lama, nilai default MSBuildExtensionsPath menunjuk ke jalur subfolder MSBuild di bawah folder \Program Files\ atau \Program Files (x86), tergantung pada bitness proses saat ini. Misalnya, untuk proses 32-bit pada komputer 64-bit, properti ini menunjuk ke folder \Program Files (x86). Untuk proses 64-bit pada komputer 64-bit, properti ini menunjuk ke folder \Program Files. Jangan sertakan garis miring terbalik terakhir pada properti ini. Lokasi ini adalah tempat yang berguna untuk menempatkan file target kustom. Misalnya, file target Anda dapat diinstal di \Program Files\MSBuild\MyFiles\Northwind.targets lalu diimpor dalam file proyek dengan menggunakan kode XML ini: <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>	C:\Program Files\Microsoft Visual Studio\2022\MSBuild
MSBuildExtensionsPath32	Populer	Jalur subfolder MSBuild di bawah folder \Program Files atau \Program Files (x86). Jalur selalu menunjuk ke folder \Program Files (x86) 32-bit pada komputer 32-bit dan \Program Files pada komputer 64-bit.". Lihat juga MSBuildExtensionsPath dan MSBuildExtensionsPath64. Jangan sertakan garis miring terbalik terakhir pada properti ini.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild
MSBuildExtensionsPath64	Populer	Jalur subfolder MSBuild di bawah folder \Program Files. Untuk komputer 64-bit, jalur ini selalu menunjuk ke folder \Program Files. Untuk komputer 32-bit, jalur ini kosong. Lihat juga MSBuildExtensionsPath dan MSBuildExtensionsPath32. Jangan sertakan garis miring terbalik terakhir pada properti ini.	C:\Program Files\MSBuild
MSBuildFileVersion	Dicadangkan	Rakitan MSBuild versi 4 yang digunakan untuk membangun proyek.	17.4.0.46505
MSBuildFrameworkToolsPath	Populer	Jalur ke alat .NET Framework yang dibangun dengan MSBuild yang sedang dijalankan, dengan garis miring berikutnya.	C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\
MSBuildFrameworkToolsPath32	Populer	Jalur ke versi 32-bit dari alat .NET Framework untuk versi kerangka kerja yang sama dengan MSBuild yang sedang dijalankan dibuat, dengan garis miring berikutnya.	C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\
MSBuildFrameworkToolsPath64	Populer	Jalur ke versi 64-bit dari alat .NET Framework untuk versi kerangka kerja yang sama dengan MSBuild yang sedang dijalankan dibangun dengan, dengan garis miring berikutnya.	C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\
MSBuildInteractive	Dicadangkan	true jika MSBuild berjalan secara interaktif, memungkinkan input pengguna. Pengaturan ini dikontrol oleh -interactive opsi baris perintah.	false
MSBuildLastTaskResult	Dicadangkan	truejika tugas sebelumnya selesai tanpa kesalahan (bahkan jika ada peringatan), atau false jika tugas sebelumnya memiliki kesalahan. Biasanya, ketika kesalahan terjadi dalam tugas, kesalahan adalah hal terakhir yang terjadi dalam proyek tersebut. Oleh karena itu, nilai properti ini tidak pernah false, kecuali dalam skenario ini: - Ketika atribut ContinueOnErrorTugas elemen (MSBuild) diatur ke WarnAndContinue (atau true) atau ErrorAndContinue. - Ketika Target memiliki elemen OnError (MSBuild) sebagai elemen turunan.	true
MSBuildNodeCount	Dicadangkan	Jumlah maksimum proses bersamaan yang digunakan saat membangun. Ini adalah nilai yang Anda tentukan untuk -maxcpucount pada baris perintah. Jika Anda menentukan -maxcpucount tanpa menentukan nilai, maka MSBuildNodeCount tentukan jumlah prosesor di komputer. Untuk informasi selengkapnya, lihat Referensi baris perintah dan Membangun beberapa proyek secara paralel.	1
MSBuildOverrideTasksPath	Populer	Lokasi untuk .overridetasks mencari file, yang dapat digunakan untuk menyediakan versi kustom tugas standar. Lihat Tugas MSBuild. Jangan sertakan garis miring terbalik terakhir di jalur.
MSBuildProgramFiles32	Dicadangkan	Lokasi folder program 32-bit; misalnya, C:\Program Files (x86). Jangan sertakan garis miring terbalik terakhir pada properti ini.	C:\Program Files (x86)
MSBuildProjectDefaultTargets	Dicadangkan	Daftar lengkap target yang ditentukan dalam atribut DefaultTargets dari elemen Project. Misalnya, elemen berikut Project akan memiliki MSBuildDefaultTargets nilai properti : A;B;C <Project DefaultTargets="A;B;C" >	Build
MSBuildProjectDirectory	Dicadangkan	Jalur absolut direktori tempat file proyek berada, misalnya C:\MyCompany\MyProduct. Jangan sertakan garis miring terbalik terakhir pada properti ini.	C:\Source\Repos\ConsoleApp1\ConsoleApp1
MSBuildProjectDirectoryNoRoot	Dicadangkan	Nilai properti MSBuildProjectDirectory, tidak termasuk drive akar. Jangan sertakan garis miring terbalik terakhir pada properti ini.	Source\Repos\ConsoleApp1\ConsoleApp1
MSBuildProjectExtension	Dicadangkan	Ekstensi nama file dari file proyek, termasuk periode; misalnya, .proj.	.csproj
MSBuildProjectFile	Dicadangkan	Nama file lengkap file proyek, termasuk ekstensi nama file; misalnya, MyApp.proj.	ConsoleApp1.csproj
MSBuildProjectFullPath	Dicadangkan	Jalur absolut dan nama file lengkap file proyek, termasuk ekstensi nama file; misalnya, C:\MyCompany\MyProduct\MyApp.proj.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj
MSBuildProjectName	Dicadangkan	Nama file dari file proyek tanpa ekstensi nama file; misalnya, MyApp.	ConsoleApp1
MSBuildRuntimeType	Dicadangkan	Jenis runtime yang saat ini sedang dijalankan. Diperkenalkan di MSBuild 15. Nilai mungkin tidak terdefinisi (sebelum MSBuild 15), Full menunjukkan bahwa MSBuild berjalan di desktop .NET Framework, Core menunjukkan bahwa MSBuild berjalan pada .NET Core (misalnya dalam dotnet build), atau Mono menunjukkan bahwa MSBuild berjalan pada Mono.	Full
MSBuildStartupDirectory	Dicadangkan	Jalur absolut folder tempat MSBuild dipanggil. Dengan menggunakan properti ini, Anda dapat membangun semuanya di bawah titik tertentu di pohon proyek tanpa membuat <file dirs.proj> di setiap direktori. Sebagai gantinya, Anda hanya memiliki satu proyek—misalnya, c:\traversal.proj, seperti yang ditunjukkan di sini: <Project ...> <ItemGroup> <ProjectFiles Include="$ (MSBuildStartupDirectory) **\*.csproj"/> </ItemGroup> <Target Name="build"> <MSBuild Projects="@(ProjectFiles)"/> </Target> </Project> Untuk membangun kapan saja di pohon, ketik: msbuild c:\traversal.proj Jangan sertakan garis miring terbalik terakhir pada properti ini.	c:\Source\Repos\ConsoleApp1
MSBuildThisFile	Dicadangkan	Bagian nama file dan ekstensi file dari MSBuildThisFileFullPath.	ConsoleApp1.csproj
MSBuildThisFileDirectory	Dicadangkan	Bagian direktori dari MSBuildThisFileFullPath. Sertakan garis miring terbalik terakhir di jalur.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\
MSBuildThisFileDirectoryNoRoot	Dicadangkan	Bagian direktori dari MSBuildThisFileFullPath, tidak termasuk drive akar. Sertakan garis miring terbalik terakhir di jalur.	Source\Repos\ConsoleApp1\ConsoleApp1\
MSBuildThisFileExtension	Dicadangkan	Bagian ekstensi nama file dari MSBuildThisFileFullPath.	.csproj
MSBuildThisFileFullPath	Dicadangkan	Jalur absolut dari proyek atau file target yang berisi target yang sedang berjalan. Tips: Anda dapat menentukan jalur relatif dalam file target yang relatif terhadap file target dan tidak relatif terhadap file proyek asli.	c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj
MSBuildThisFileName	Dicadangkan	Bagian nama file dari MSBuildThisFileFullPath, tanpa ekstensi nama file.	ConsoleApp1
MSBuildToolsPath	Dicadangkan	Jalur penginstalan versi MSBuild yang terkait dengan nilai MSBuildToolsVersion. Jangan sertakan garis miring terbalik terakhir di jalur. Properti ini tidak dapat ditimpa.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildToolsPath32	Populer	Jalur penginstalan versi MSBuild 32-bit yang terkait dengan nilai MSBuildToolsVersion. Jangan sertakan garis miring terbalik terakhir di jalur. Properti ini tidak dapat ditimpa.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin
MSBuildToolsPath64	Populer	Jalur penginstalan versi MSBuild 64-bit yang terkait dengan nilai MSBuildToolsVersion. Jangan sertakan garis miring terbalik terakhir di jalur. Properti ini tidak dapat ditimpa.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
MSBuildToolsVersion	Dicadangkan	Versi MSBuild Toolset yang digunakan untuk membangun proyek. Catatan: MSBuild Toolset terdiri dari tugas, target, dan alat yang digunakan untuk membangun aplikasi. Alat ini mencakup pengompilasi, seperti csc.exe dan vbc.exe. Untuk informasi selengkapnya, lihat Toolset (ToolsVersion), dan Konfigurasi Toolset Standar dan kustom.	Current
MSBuildSDKsPath	Populer	Jalur yang digunakan MSBuild untuk menemukan SDK.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Sdks
MSBuildSemanticVersion	Dicadangkan	Versi semver 2.0 lengkap dari rakitan MSBuild digunakan untuk membangun proyek.	17.4.0-preview-22465-05+6033e4c95
MSBuildUserExtensionsPath	Populer	Jalur ini menyediakan lokasi untuk folder penginstalan MSBuild. Ini dapat diatur ulang untuk menyediakan kustomisasi lokal per pengguna. Lihat Menyesuaikan build lokal Anda. Jangan sertakan garis miring terbalik terakhir di jalur.
MSBuildVersion	Dicadangkan	Versi MSBuild yang digunakan untuk membangun proyek. Properti ini tidak dapat ditimpa, jika tidak, pesan MSB4004 - The 'MSBuildVersion' property is reserved, and can't be modified. kesalahan dikembalikan.	17.4.0
MSBuildWarningsAsErrors	Populer	Daftar kode peringatan untuk diperlakukan sebagai kesalahan.	MSB1234;MSB5678
MSBuildWarningsAsMessages	Populer	Daftar kode peringatan untuk diperlakukan sebagai pesan.	MSB1234;MSB5678
MSBuildWarningsNotAsErrors	Populer	Daftar kode peringatan yang tidak boleh dipromosikan ke kesalahan bahkan jika -warnAsError sakelar diatur untuk mempromosikan semua peringatan lainnya ke kesalahan. Perhatikan bahwa itu tidak berpengaruh jika itu tidak benar.	MSB1234;MSB5678
OS	Populer	Pada Windows, ini diwariskan dari sistem operasi host. Nilai yang mungkin termasuk "Windows_NT" dan "Unix"; dapat diatur ke nilai yang berbeda pada sistem operasi selain Windows.
RoslynTargetsPath	Populer	Jalur ke target untuk kompilator Roslyn.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\Roslyn
SDK35ToolsPath	Populer	Jalur ke alat .NET Framework 3.5.
SDK40ToolsPath	Populer	Jalur ke alat .NET Framework 4.0.	C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\
VsInstallRoot	Populer	Folder penginstalan Visual Studio.	C:\Program Files\Microsoft Visual Studio\2022
WindowsSDK80Path	Populer	Jalur ke Windows 8 SDK.

Properti khusus untuk proyek C++

Properti berikut mewakili jalur ke file impor C++ MSBuild, seperti .props file dan .targets , untuk berbagai versi toolset C++ dan sistem operasi target. File dalam folder ini mewakili infrastruktur build C++ dan sangat penting untuk membangun proyek C++ apa pun dengan MSBuild.

Properti	Dicadangkan atau populer	Deskripsi	Contoh
AndroidTargetsPath	Populer	Jalur ke file impor C++ MSBuild untuk build Android.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\MDD\Android\V150\
iOSTargetsPath	Populer	Jalur ke file impor C++ MSBuild untuk build iOS.	C:\Program Files\Microsoft Visual Studio\2022\Preview\MSBuild\Microsoft\MDD\iOS\V150\
VCTargetsPath	Populer	Jalur ke file C++ MSBuild yang mendukung sistem build C++.	C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\VC\v170\
VCTargetsPath10	Populer	Jalur ke file C++ MSBuild yang mendukung toolset Visual Studio 2010.	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\
VCTargetsPath11	Populer	Jalur ke file impor MSBuild untuk toolset Visual Studio 2012 (V110).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V110\
VCTargetsPath12	Populer	Jalur ke file impor MSBuild untuk toolset Visual Studio 2013 (V120).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\
VCTargetsPath14	Populer	Jalur ke file impor MSBuild untuk toolset Visual Studio 2015 (V140).	C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V140\

Nama yang bertentangan dengan elemen MSBuild

Selain hal di atas, nama yang sesuai dengan elemen bahasa MSBuild tidak dapat digunakan untuk properti, item, atau metadata item yang ditentukan pengguna:

• VisualStudioProject
• Target
• PropertyGroup
• Output
• ItemGroup
• UsingTask
• ProjectExtensions
• OnError
• ImportGroup
• Pilih
• Kapan
• Jika tidak

Lihat juga

• Referensi MSBuild

• Properti MSBuild