Aracılığıyla paylaş


Ortak MSBuild proje özellikleri

Aşağıdaki tabloda, Visual Studio proje dosyalarında tanımlanan veya MSBuild tarafından sunulan .targets dosyalarında bulunan sık kullanılan özellikler listelenmiştir.

.NET SDK tarafından sağlanan özellikler , Microsoft.Net.Sdk için MSBuild başvurusu sayfasında belgelenmiştir.

Visual Studio'daki proje dosyaları (.csproj, .vbproj, .vcxprojve diğerleri), IDE kullanarak bir proje oluşturduğunuzda çalıştırılan MSBuild XML kodunu içerir. Projeler genellikle bir veya daha fazla .targets dosyalarını içeri aktararak derleme işlemlerini tanımlar. Daha fazla bilgi için bkz. MSBuild .targets dosyaları.

Özellik değerlerini ayarlarken, genel özelliklerin ayarlanabileceğini, sıfırlandığını veya bir dizi içeri aktarılan dosyada kullanılabileceğini unutmayın. Bu nedenle, proje dosyanızda, Directory.Build.propsveya başka bir içeri aktarılan dosyada bir özelliği ayarladığınız yer önemlidir. Bir özellik ayarlıyor ve beklenen sonucu alamıyorsanız, Sdk özniteliğini kullanırken örtük olarak eklenen içeri aktarmalar da dahil olmak üzere, özelliğin projeniz tarafından içeri aktarılan tüm dosyalarda nerede ve nasıl değiştirildiğini veya kullanıldığını göz önünde bulundurun. bkz. .props veya .targets dosyasına özellik ekleme arasında seçim yapma. Ön işleme bu konuda yardımcı olabilir (MSBuild komut satırı başvurusu /preprocess/pp veya komut satırı seçeneğine bakın).

Ortak özelliklerin ve parametrelerin listesi

Özellik veya parametre adı Proje türleri Açıklama
AdditionalLibPaths .NET Derleyicilerin başvuru derlemelerini araması gereken ek klasörleri belirtir.
AddModules .NET Derleyicinin, belirtilen dosyalardan gelen tüm tür bilgilerini derlediğiniz proje için kullanılabilir hale getirmesine neden olur. Bu özellik, /addModules derleyici anahtarına eşdeğerdir.
ALToolPath .NET AL.exeyolu. Bu özellik, farklı bir sürümün kullanımını etkinleştirmek için geçerli AL.exe sürümünü geçersiz kılar.
ApplicationIcon .NET Win32 simgesi olarak eklemek üzere derleyiciye geçirmek üzere .ico simgesi dosyası. özelliği, /win32icon derleyici anahtarına eşdeğerdir.
ApplicationManifest Tüm Dış Kullanıcı Hesabı Denetimi (UAC) bildirim bilgileri oluşturmak için kullanılan dosyanın yolunu belirtir. Yalnızca Windows Vista'ya yönelik Visual Studio projeleri için geçerlidir.

Çoğu durumda bildirim eklenir. Ancak, KayıtSız COM veya ClickOnce dağıtımı kullanıyorsanız bildirim, uygulama derlemelerinizle birlikte yüklenen bir dış dosya olabilir. Daha fazla bilgi için bu makaledeki NoWin32Manifest özelliğine bakın.
AssemblyOriginatorKeyFile .NET Derlemeyi imzalamak için kullanılan dosyayı (.snk veya .pfx) belirtir ve derlemeyi imzalamak için kullanılan gerçek anahtarı oluşturmak için ResolveKeySource görevine geçirilir.
AssemblySearchPaths .NET Derleme zamanı başvurusu derleme çözümlemesi sırasında aranacak konumların listesi. Bu listede yolların görünme sırası anlamlıdır çünkü daha önce listelenen yollar sonraki girişlere göre önceliklidir.
AssemblyName .NET Proje oluşturulduktan sonra son çıkış derlemesinin adı.
Özellik veya parametre adı Proje türleri Açıklama
BaseAddress .NET Ana çıkış derlemesinin temel adresini belirtir. Bu özellik, /baseaddress derleyici anahtarına eşdeğerdir.
BaseIntermediateOutputPath Tüm Yapılandırmaya özgü tüm ara çıkış klasörlerinin oluşturulduğu en üst düzey klasör. Varsayılan değer obj\. Aşağıdaki kod bir örnektir: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath>
BaseOutputPath Tüm Çıkış dosyasının temel yolunu belirtir. Ayarlandıysa, MSBuild OutputPath = $(BaseOutputPath)\$(Configuration)\kullanır. Örnek söz dizimi: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath>
BuildInParallel Tüm Multi-Proc MSBuild kullanıldığında proje başvurularının paralel olarak derlenip derlenmediğini veya temizlendiğini gösteren boole değeri. Varsayılan değer truedeğeridir. Bu, sistemin birden çok çekirdeği veya işlemcisi varsa projelerin paralel olarak derlendiği anlamına gelir.
BuildProjectReferences Tüm Proje başvurularının MSBuild tarafından derlenip derlendiğini gösteren boole değeri. Projenizi Visual Studio tümleşik geliştirme ortamında (IDE) oluşturuyorsanız otomatik olarak false olarak ayarlayın, aksi takdirde true. başvuruda bulunılan projelerin güncel olup olmadığını denetlemekten kaçınmak için komut satırında -p:BuildProjectReferences=false belirtilebilir.
Özellik veya parametre adı Proje türleri Açıklama
CleanFile Tüm "Temiz önbellek" olarak kullanılacak dosyanın adı. Temiz önbellek, temizleme işlemi sırasında silinecek oluşturulan dosyaların listesidir. Dosya, derleme işlemi tarafından ara çıkış yoluna konur.

Bu özellik yalnızca yol bilgisi olmayan dosya adlarını belirtir.
CodePage .NET Derlemedeki tüm kaynak kodu dosyaları için kullanılacak kod sayfasını belirtir. Bu özellik, /codepage derleyici anahtarına eşdeğerdir.
CompilerResponseFile .NET Derleyici görevlerine geçirilebilen isteğe bağlı bir yanıt dosyası.
Konfigürasyon Tüm Oluşturduğunuz yapılandırma, genellikle Debug veya Release, ancak çözüm ve proje düzeylerinde yapılandırılabilir.
CscToolPath C# csc.exeyolu, C# derleyicisi.
CustomAfterMicrosoftCommonTargets Tüm Ortak hedefler içeri aktarıldıktan sonra otomatik olarak içeri aktarılacak bir proje dosyasının veya hedef dosyasının adı.
CustomBeforeMicrosoftCommonTargets Tüm Ortak hedefler içeri aktarma işleminden önce otomatik olarak içeri aktarılacak bir proje dosyasının veya hedef dosyasının adı.
Özellik veya parametre adı Proje türleri Açıklama
DebugSymbols Tüm Derleme tarafından simgelerin oluşturulup oluşturulmadığını gösteren boole değeri.

Komut satırında -p:DebugSymbols=false ayarı, program veritabanının (.pdb) simge dosyalarının oluşturulmasını devre dışı bırakır.
DebugType Tüm Oluşturulmasını istediğiniz hata ayıklama bilgilerinin düzeyini tanımlar. Geçerli değerler "tam", "pdbonly", "taşınabilir", "katıştırılmış" ve "yok" değerleridir.
DefineConstants .NET Koşullu derleyici sabitlerini tanımlar. Sembol/değer çiftleri noktalı virgülle ayrılır ve dile bağımlı söz dizimi kullanılarak belirtilir:

C#: symbol1; symbol2

Visual Basic: symbol1 = value1, symbol2 = value2

özelliği, /define derleyici anahtarına eşdeğerdir.
DefineDebug Tüm DEBUG sabitinin tanımlanmasını isteyip istemediğinizi gösteren boole değeri.
DefineTrace Tüm TRACE sabitinin tanımlanmasını isteyip istemediğinizi gösteren boole değeri.
DelaySign .NET Derlemeyi tam olarak imzalamak yerine gecikmeli imzalamak isteyip istemediğinizi gösteren boole değeri.
Deterministic .NET Derleyicinin özdeş girişler için aynı derlemeler oluşturup oluşturmayacağını gösteren boole değeri. Bu parametre, derleyicilerin /deterministic anahtarına karşılık gelir.
DirectoryBuildPropsPath Tüm Directory.Build.props dosyasının yolunu belirtir; tanımlanırsa, bu özellik varsayılan arama algoritmasını geçersiz kılar. Bkz. Derlemenizi özelleştirme.
DirectoryBuildTargetsPath Tüm Directory.Build.targets dosyasının yolunu belirtir; tanımlanırsa, bu özellik varsayılan arama algoritmasını geçersiz kılar. Bkz. Derlemenizi özelleştirme.
DisableFastUpToDateCheck Tüm Yalnızca Visual Studio için geçerli olan boole değeri. Visual Studio derleme yöneticisi, bir projenin güncel olması için yeniden oluşturulması gerekip gerekmediğini belirlemek için FastUpToDateCheck adlı bir işlem kullanır. Bu işlem, bunu belirlemek için MSBuild kullanmaktan daha hızlıdır. DisableFastUpToDateCheck özelliğinin true olarak ayarlanması, Visual Studio derleme yöneticisini atlamanıza ve projenin güncel olup olmadığını belirlemek için MSBuild kullanmaya zorlamanıza olanak tanır.
DocumentationFile .NET XML belge dosyası olarak oluşturulan dosyanın adı. Bu ad yalnızca dosya adını içerir ve yol bilgisi yoktur.
Özellik veya parametre adı Proje türleri Açıklama
ErrorReport .NET Derleyici görevinin iç derleyici hatalarını nasıl rapor etmesi gerektiğini belirtir. Geçerli değerler "istem", "gönder" veya "yok" değerleridir. Bu özellik, /errorreport derleyici anahtarına eşdeğerdir.
ExcludeDeploymentUrl .NET GenerateDeploymentManifest görev proje dosyasında aşağıdaki öğelerden herhangi biri varsa dağıtım bildirimine bir deploymentProvider etiketi eklenir:

- UpdateUrl
- InstallUrl
- PublishUrl

Ancak ExcludeDeploymentUrl kullanarak, yukarıdaki URL'lerden herhangi biri belirtilse bile deploymentProvider etiketinin dağıtım bildirimine eklenmesini engelleyebilirsiniz. Bunu yapmak için proje dosyanıza aşağıdaki özelliği ekleyin:

<ExcludeDeploymentUrl>true</ExcludeDeploymentUrl>

Not: ExcludeDeploymentUrl Visual Studio IDE'de gösterilmez ve yalnızca proje dosyası el ile düzenlenerek ayarlanabilir. Bu özelliğin ayarlanması Visual Studio'da yayımlamayı etkilemez; yani deploymentProvider etiketi Yine de PublishUrl tarafından belirtilen URL'ye eklenir.
FileAlignment .NET Çıkış dosyasının bölümlerinin hizalandığı yeri bayt cinsinden belirtir. Geçerli değerler: 512, 1024, 2048, 4096, 8192. Bu özellik, /filealignment derleyici anahtarına eşdeğerdir.
FrameworkPathOverride Visual Basic mscorlib.dll ve microsoft.visualbasic.dllkonumunu belirtir. Bu parametre, /sdkpath derleyicisinin anahtarına eşdeğerdir.
GenerateDocumentationFile .NET Derleme tarafından belge oluşturulup oluşturulmadığını gösteren boole parametresi. truederleme, belge bilgileri oluşturur ve derleme görevinin oluşturduğu yürütülebilir dosya veya kitaplığın adıyla birlikte .xml bir dosyaya yerleştirir.
GenerateFullPaths C# -fullpaths derleyici seçeneğini kullanarak çıktıdaki dosya adları için tam yollar oluşturun.
GenerateSerializationAssemblies .NET XML serileştirme derlemelerinin açık, otomatik veya kapalı olarak ayarlanabilen SGen.exetarafından oluşturulup oluşturulmayacağını gösterir. Bu özellik yalnızca .NET Framework'i hedefleyen derlemeler için kullanılır. .NET Standard veya .NET Core derlemeleri için XML serileştirme derlemeleri oluşturmak için Microsoft.XmlSerializer.Generator NuGet paketine başvurun.
Özellik veya parametre adı Proje türleri Açıklama
ImportDirectoryBuildProps Tüm Directory.Build.props dosyasının içeri aktarılıp aktarılmayacağını gösteren boole değeri. Bkz. Derlemenizi özelleştirme.
ImportDirectoryBuildTargets Tüm Directory.Build.targets dosyasının içeri aktarılıp aktarılmayacağını gösteren boole değeri. Bkz. Derlemenizi özelleştirme.
IntermediateOutputPath Tüm Hiçbir yol belirtilmezse, BaseIntermediateOutputPathtüretilen tam ara çıkış yolu. Örneğin, obj\debug\ .
KeyContainerName Tüm Tanımlayıcı ad anahtar kapsayıcısının adı.
KeyOriginatorFile Tüm Tanımlayıcı ad anahtar dosyasının adı.
ModuleAssemblyName .NET Derlenen modülün birleştirileceği derlemenin adı. özelliği, /moduleassemblyname derleyici anahtarına eşdeğerdir.
MSBuildProjectExtensionsPath Tüm Proje uzantılarının bulunduğu yolu belirtir. Varsayılan olarak, bu değer BaseIntermediateOutputPathile aynı değeri alır.
MSBuildTreatWarningsAsErrors Tüm MSBuild'e, gizlenmediği sürece tüm uyarıları hata olarak işlemesini söyleyen boole değeri.
MSBuildWarningsAsErrors Tüm Hata olarak ele alınacak uyarı kodlarının listesini belirtir. Birden çok uyarıyı noktalı virgülle ayırın. WarningsAsErrors.NET SDK özelliğini kullanıyorsanız, MSBuildWarningsAsErrors varsayılan olarak WarningsAsErrorsdeğerine sahip olur.
MSBuildWarningsAsMessages Tüm Düşük öneme sahip iletiler olarak ele alarak gizlenecek uyarı kodlarının listesini belirtir. Birden çok uyarıyı noktalı virgülle ayırın. MSBuild tarafından yayılan bazı uyarıların bu özellik kullanılarak gizlenebileceğini unutmayın; bunları engellemek için -warnAsMessagekomut satırı anahtarını kullanın. NoWarn.NET SDK özelliğini kullanıyorsanız, MSBuildWarningsAsMessages varsayılan olarak NoWarndeğerine sahip olur.
Özellik veya parametre adı Proje türleri Açıklama
NoLogo Tüm Derleyici logosunu kapatmak isteyip istemediğinizi gösteren boole değeri. Bu özellik, /nologo derleyici anahtarına eşdeğerdir.
NoStdLib .NET Standart kitaplığa (mscorlib.dll) başvurmaktan kaçınılıp kaçınılmayacağını gösteren boole değeri. Varsayılan değer false.
NoVBRuntimeReference Visual Basic Visual Basic çalışma zamanının (Microsoft.VisualBasic.dll) projeye başvuru olarak eklenip eklenmeyeceğini gösteren boole değeri.
NoWarn .NET Belirtilen uyarıları gizler. Uyarı tanımlayıcısının yalnızca sayısal bölümü belirtilmelidir. Birden çok uyarı noktalı virgülle ayrılır. Bu parametre, derleyicilerin /nowarn anahtarına karşılık gelir.
NoWin32Manifest .NET Kullanıcı Hesabı Denetimi (UAC) bildirim bilgilerinin uygulamanın yürütülebilir dosyaya eklenip ekli olmayacağını gösteren boole değeri. Yalnızca Windows Vista'ya yönelik Visual Studio projeleri için geçerlidir. ClickOnce ve Registration-Free COM kullanılarak dağıtılan projelerde bu öğe yoksayılır. False (varsayılan değer), Kullanıcı Hesabı Denetimi (UAC) bildirim bilgilerinin uygulamanın yürütülebilir dosyası içine eklendiğini belirtir. True UAC bildirim bilgilerinin eklenmediğini belirtir.

Bu özellik yalnızca Windows Vista'ya yönelik Visual Studio projeleri için geçerlidir. ClickOnce ve Registration-Free COM kullanılarak dağıtılan projelerde bu özellik yoksayılır.

NoWin32Manifest'i yalnızca Visual Studio'nun uygulamanın yürütülebilir dosyalarına herhangi bir bildirim bilgisi eklemesini istemiyorsanız eklemeniz gerekir; bu işleme sanallaştırmaadı verilir. Sanallaştırmayı kullanmak için <ApplicationManifest><NoWin32Manifest> ile birlikte aşağıdaki gibi ayarlayın:

- Visual Basic projeleri için <ApplicationManifest> düğümünü kaldırın. (Visual Basic projelerinde bir <NoWin32Manifest> düğümü mevcut olduğunda <ApplicationManifest> yoksayılır.)
- C# projeleri için <ApplicationManifest>False ve <NoWin32Manifest>Trueolarak ayarlayın. (C# projelerinde <ApplicationManifest><NoWin32Manifest>geçersiz kılar.)
Bu özellik, /nowin32manifest derleyici anahtarına eşdeğerdir.
Optimize .NET trueolarak ayarlandığında derleyici iyileştirmelerini etkinleştiren boole değeri. Bu özellik, /optimize derleyici anahtarına eşdeğerdir.
OptionCompare VisualBasic Dize karşılaştırmalarının nasıl yapıldığını belirtir. Geçerli değerler "ikili" veya "metin" şeklindedir. Bu özellik, /optioncompare derleyici anahtarına eşdeğerdir.
OptionExplicit Visual Basic trueolarak ayarlandığında kaynak koddaki değişkenlerin açık bildirimini gerektiren boole değeri. Bu özellik, /optionexplicit derleyici anahtarına eşdeğerdir.
OptionInfer Visual Basic trueolarak ayarlandığında değişkenlerin tür çıkarımına olanak tanıyan boole değeri. Bu özellik, /optioninfer derleyici anahtarına eşdeğerdir.
OptionStrict Visual Basic trueolarak ayarlandığında, derleme görevinin örtük tür dönüştürmelerini kısıtlamak için katı tür semantiğini zorlamasına neden olan boole değeri. Bu özellik, /optionstrict derleyicisinin anahtarına eşdeğerdir.
OutDir Tüm Proje veya çözüm için son çıkış konumunu gösterir. Bir çözüm oluştururken OutDir, birden çok proje çıkışını tek bir konumda toplamak için kullanılabilir. Ayrıca OutDir, başvuruları çözümlemek için kullanılan AssemblySearchPaths'e dahil edilir. Örneğin, bin\Debug.
OutputPath Tüm Çıkış dizininin yolunu proje dizinine göre belirtir; örneğin, AnyCPU olmayan derlemelerde bin\Debug veya bin\Debug\$(Platform).
OutputType Tüm Çıkış dosyasının dosya biçimini belirtir. Bu parametre aşağıdaki değerlerden birine sahip olabilir:

-Kütüphane. Bir kod kitaplığı oluşturur. (Varsayılan değer.)
- Exe. Bir konsol uygulaması oluşturur.
-Modül. Bir modül oluşturur.
- Winexe. Windows tabanlı bir program oluşturur.

C# ve Visual Basic için bu özellik /target anahtarına eşdeğerdir. Çıkış türü çıkarılarak otomatik olarak geçersiz kılınabilir. Bkz. wpf için WinExe ve WinForms uygulamaları ayarlanmış outputtype. DisableWinExeOutputInference trueolarak ayarlayarak çıkarımı devre dışı bırakın.
OverwriteReadOnlyFiles Tüm Derlemenin salt okunur dosyaların üzerine yazılmasını mı yoksa hata tetiklemesini mi istediğinizi gösteren boole değeri.
Özellik veya parametre adı Proje türleri Açıklama
PathMap .NET Fiziksel yolların derleyici tarafından çıkış olarak kaynak yol adlarına nasıl eş yapılacağını belirtir. Bu özellik, derleyicilerin /pathmap anahtarına eşdeğerdir.
PdbFile .NET Yaydığınız .pdb dosyasının dosya adı. Bu özellik, /pdb derleyicisinin anahtarına eşdeğerdir.
Peron Tüm Oluşturmakta olduğunuz işletim sistemi. .NET Framework derlemelerine örnek olarak "Any CPU", "x86" ve "x64" verilebilir.
ProcessorArchitecture .NET Derleme başvuruları çözümlendiğinde kullanılan işlemci mimarisi. Geçerli değerler şunlardır: "msil," "x86," "amd64" veya "ia64."
ProduceOnlyReferenceAssembly .NET Derleyiciye derlenmiş kod yerine yalnızca bir başvuru derlemesi yaymasını belirten boole değeri. ProduceReferenceAssemblyile birlikte kullanılamaz. Bu özellik, /refonly ve csc.exe derleyicilerinin anahtarına karşılık gelir.
ProduceReferenceAssembly .NET true olarak ayarlandığında geçerli derleme için başvuru derlemelerinin üretilmesini sağlayan boole değeri. Deterministic bu özellik kullanılırken true olmalıdır. Bu özellik, /refout ve csc.exe derleyicilerinin anahtarına karşılık gelir.
RegisterAssemblyMSBuildArchitecture Yalnızca Windows Yönetilen DLL'nin kaydedildiği varsayılan mimariyi belirtir. COM, kayıtları mimariye özgü hive'larda depolamak için Windows kayıt defterini kullandığından bu özellik kullanışlıdır. Örneğin, Bir Windows sisteminde, AnyCPU yönetilen derlemenin türleri 64 bit kovana ve/veya 32 bit (WoW) kovana kaydedilmiş olabilir ve derleme, mimariye özgü kayıt defteri kovanını belirlemek için bu özelliği kullanır. Geçerli değerler şunlardır: "x86," "x64" ve "ARM64."
RegisterForCOMInterop Yalnızca Windows Yönetilen uygulamanızın bir COM nesnesi (COM çağrılabilen sarmalayıcı) göstereceğini gösterir. Derleme sayfası - Çıkış bölümünebakın. Bu ayar yalnızca projenin oluşturulduğu makineyi etkiler. Diğer makinelere dağıtıyorsanız, derlemeyi hedef makineye kaydetmek için regasm.exe çağırın.
RemoveIntegerChecks Visual Basic Tamsayı taşması hata denetimlerinin devre dışı bırakılıp devre dışı bırakılmayacağını gösteren boole değeri. Varsayılan değer false. Bu özellik, /removeintchecks derleyicisinin anahtarına eşdeğerdir.
RootNamespace Tüm Ekli bir kaynağı adlandırırken kullanılacak kök ad alanı. Bu ad alanı, eklenmiş kaynak bildirimi adının bir parçasıdır.
Özellik veya parametre adı Proje türleri Açıklama
Satellite_AlgorithmId .NET Uydu derlemeleri oluşturulduğunda kullanılacak AL.exe karma algoritmasının kimliği.
Satellite_BaseAddress .NET Kültüre özgü uydu derlemeleri CreateSatelliteAssemblies hedefi kullanılarak oluşturulurken kullanılacak temel adres.
Satellite_CompanyName .NET Uydu derlemesi oluşturma sırasında AL.exe geçirecek şirket adı.
Satellite_Configuration .NET Uydu derlemesi oluşturma sırasında AL.exe geçirmek için yapılandırma adı.
Satellite_Description .NET Uydu derlemesi oluşturma sırasında AL.exe geçirecek açıklama metni.
Satellite_EvidenceFile .NET Belirtilen dosyayı "Security.Evidence" kaynak adına sahip uydu derlemesine ekler.
Satellite_FileVersion .NET Uydu derlemesindeki Dosya Sürümü alanı için bir dize belirtir.
Satellite_Flags .NET Uydu derlemesindeki Flags alanı için bir değer belirtir.
Satellite_GenerateFullPaths .NET Derleme görevinin hata iletisinde bildirilen tüm dosyalar için mutlak yollar kullanmasına neden olur.
Satellite_LinkResource .NET Belirtilen kaynak dosyalarını bir uydu derlemesine bağlar.
Satellite_MainEntryPoint .NET Bir modül uydu derlemesi oluşturma sırasında yürütülebilir dosyaya dönüştürüldüğünde giriş noktası olarak kullanılacak yöntemin tam adını (class.method) belirtir.
Satellite_ProductName .NET Uydu derlemesindeki Product alanı için bir dize belirtir.
Satellite_ProductVersion .NET Uydu derlemesindeki ProductVersion alanı için bir dize belirtir.
Satellite_TargetType .NET Uydu derleme çıktı dosyasının dosya biçimini "kitaplık", "exe" veya "win" olarak belirtir. Varsayılan değer "kitaplık"tır.
Satellite_Title .NET Uydu derlemesindeki Title alanı için bir dize belirtir.
Satellite_Trademark .NET Uydu derlemesindeki Ticari Marka alanı için bir dize belirtir.
Satellite_Version .NET Uydu derlemesinin sürüm bilgilerini belirtir.
Satellite_Win32Icon .NET Uydu derlemesine bir .ico simgesi dosyası ekler.
Satellite_Win32Resource .NET Uydu derlemesine bir Win32 kaynağı (.res dosyası) ekler.
SGenToolPath .NET geçerli SGen.exe sürümü geçersiz kılındığında SGen.exe nereden alındığını gösteren isteğe bağlı bir araç yolu.
Özellik veya parametre adı Proje türleri Açıklama
SGenUseProxyTypes .NET ara sunucu türlerinin SGen.exetarafından oluşturulup oluşturulmayacağını gösteren boole değeri. Bu yalnızca GenerateSerializationAssemblies açık olarak ayarlandığında geçerlidir.

SGen hedefi UseProxyTypes bayrağını ayarlamak için bu özelliği kullanır. Bu özellik varsayılan olarak true olarak ayarlanır ve bunu değiştirmek için kullanıcı arabirimi yoktur. Web hizmeti olmayan türler için serileştirme derlemesi oluşturmak için bu özelliği proje dosyasına ekleyin ve Microsoft.Common.Targets veya C#/VB.targetsiçeri aktarmadan önce false olarak ayarlayın.
SkipInvalidConfigurations Tüm true, geçersiz platform ve yapılandırma birleşimlerinde bir uyarı oluşturun, ancak derlemede başarısız olmaz; false veya tanımsız olduğunda (varsayılan), bir hata oluşturun.
StartupObject .NET Main yöntemini veya Sub Main yordamını içeren sınıfı veya modülü belirtir. Bu özellik, /main derleyici anahtarına eşdeğerdir.
SubsystemVersion .NET Oluşturulan yürütülebilir dosyanın kullanabileceği alt sistemin en düşük sürümünü belirtir. Bu özellik, /subsystemversion derleyici anahtarına eşdeğerdir. Bu özelliğin varsayılan değeri hakkında bilgi için bkz. /subsystemversion (Visual Basic) veya /subsystemversion (C# derleyici seçenekleri).
TargetCompactFramework .NET Oluşturmakta olduğunuz uygulamayı çalıştırmak için gereken .NET Compact Framework sürümü. Bunu belirtmek, aksi takdirde başvuramayacağınız belirli çerçeve derlemelerine başvurmanızı sağlar.
TargetFrameworkVersion .NET Oluşturmakta olduğunuz uygulamayı çalıştırmak için gereken .NET Framework sürümü. Bunu belirtmek, aksi takdirde başvuramayacağınız belirli çerçeve derlemelerine başvurmanızı sağlar.
TreatWarningsAsErrors .NET trueise tüm uyarıların hata olarak değerlendirilmesine neden olan boole parametresi. Bu parametre, /nowarn derleyici anahtarına eşdeğerdir.
UseCommonOutputDirectory .NET Çözümdeki tüm derleme çıkışlarının aynı çıkış dizinini kullanmasını istediğinizde true olarak ayarlayabileceğiniz boole özelliği. true, başvuruda bulunan projelerin çıkışı, bu ayarın falseolduğu gibi bu bağımlılıkları kullanan projelere kopyalanır. Bu parametrenin true olarak ayarlanması hiçbir projenin gerçek çıkış dizinini değiştirmez; Yine de çıkış dizinini gerektiren her proje için istenen ortak çıkış dizinine ayarlamanız gerekir.
UseHostCompilerIfAvailable .NET trueise derleme görevinin kullanılabilir durumdaysa işlem içi derleyici nesnesini kullanmasına neden olan boole parametresi. Bu parametre yalnızca Visual Studio tarafından kullanılır.
Utf8Output .NET trueise UTF-8 kodlaması kullanarak derleyici çıkışını günlüğe kaydeden boole parametresi. Bu parametre, /utf8Output derleyici anahtarına eşdeğerdir.
Özellik veya parametre adı Proje türleri Açıklama
VbcToolPath Visual Basic geçerli vbc.exe sürümü geçersiz kılındığında vbc.exe için başka bir konumu gösteren isteğe bağlı bir yol.
VbcVerbosity Visual Basic Visual Basic derleyicisinin çıkışının ayrıntı düzeyini belirtir. Geçerli değerler "Sessiz", "Normal" (varsayılan değer) veya "Ayrıntılı" değerleridir.
VisualStudioVersion Tüm Bu projenin çalıştığı düşünülmesi gereken Visual Studio sürümünü belirtir. Bu özellik belirtilmezse, MSBuild bunu varsayılan {VisualStudioMajorVersion}.0değerine ayarlar; örneğin, Visual Studio 2022'nin tüm sürümleri için 17.0.

Bu özellik, derleme için kullanılan hedef kümesini belirtmek üzere çeşitli proje türlerinde kullanılır. Bir proje için ToolsVersion 4.0 veya üzeri olarak ayarlanırsa, hangi alt araç takımının kullanılacağını belirtmek için VisualStudioVersion kullanılır. Daha fazla bilgi için bkz. Toolset (ToolsVersion).
UyarılarAsErrors .NET Hata olarak ele alınacak uyarıların listesini belirtir. Bu parametre, /warnaserror derleyici anahtarına eşdeğerdir.
WarningLevel Tüm Derleyici tarafından yayılan uyarılar için derleyicilere geçirecek uyarı düzeyini belirtir. Bu ayar, düzey belirlemeleri olmayan MSBuild uyarılarını etkilemez. C# derleyici belgelerinde uyarı düzeyi ve C++ derleyici belgelerinde /W (Uyarı düzeyi) .
WarningsNotAsErrors .NET Hata olarak değerlendirilmez uyarıların listesini belirtir. Bu parametre, /warnaserror derleyici anahtarına eşdeğerdir.
Win32Manifest .NET Son derlemeye katıştırılması gereken bildirim dosyasının adı. Bu parametre, /win32Manifest derleyici anahtarına eşdeğerdir.
Win32Resource .NET Son derlemeye eklenecek Win32 kaynağının dosya adı. Bu parametre, /win32resource derleyici anahtarına eşdeğerdir.

.NET SDK projelerine özgü özellikler(TargetFrameworkgibi) Framework özellikleri sayfasında belgelenmiştir.

Ayrıca bkz.

  • Ortak MSBuild proje öğelerini
  • Ortak MSBuild öğe meta verilerini
  • MSBuild Ayrılmış ve İyi Bilinen Özellikler
  • .NET SDK projeleri için MSBuild başvurusu