Yaygın MSBuild Proje Özellikleri
Aşağıdaki tabloda sık kullanılan Visual Studio projesi dosyalarında tanımlanan özellikleri veya MSBuild sağlayan .targets dosyasında bulunur.
Proje dosyaları (.csproj, .vbproj, vcxproj ve diğerleri) Visual Studio IDE kullanarak bir proje oluşturma sırasında çalıştırılan MSBuild XML kodunu içerir.Projeleri, kendi yapı sürecinin tanımlamak için bir veya daha fazla .targets dosyaları genellikle alın.Daha fazla bilgi için bkz. MSBuild .Targets Dosyaları.
Ortak Özellikler ve Parametreler listesi
Özellik veya parametre adı |
Açıklama |
|---|---|
AdditionalLibPaths |
Ek klasörler derleyiciler başvuru derlemeler için görünür belirtir. |
AddModules |
Tüm türü yapmak için derleyici neden olan bilgileri belirtilen dosyaları derleme projesi için kullanılabilir.Bu özellik eşdeğerdir /addModules derleyici anahtarı. |
ALToolPath |
AL.exe bulunduğu yolu.Bu özellik, geçerli sürümü AL.exe farklı bir sürümünü kullanımını etkinleştirmek için geçersiz kılar. |
ApplicationIcon |
Win32 simge olarak katıştırmaya için derleyici geçirilecek .ico simge dosyası.Eşdeğer özelliktir /win32icon derleyici anahtarı. |
ApplicationManifest |
Dış kullanıcı hesabı denetimi (UAC) bildirim bilgileri oluşturmak için kullanılan dosyasının yolunu belirtir.Yalnızca hedefleyen Visual Studio projeleri için geçerlidir Windows Vista. Çoğu durumda, bildirim katıştırılmış.Ancak, kayıt boş COM kullanıyorsanız veya ClickOnce dağıtım ve ardından bildirim ile birlikte, uygulama derlemeleri yüklü olduğu bir dış dosyası olabilir.Daha fazla bilgi için bu konudaki NoWin32Manifest özelliğine bakın. |
AssemblyOriginatorKeyFile |
Derleme (.snk veya .pfx) imzalamak için kullanılan ve için geçirilen dosya belirtir ResolveKeySource Görevi derleme imzalamak için kullanılan gerçek anahtarı oluşturmak için. |
AssemblySearchPaths |
Yapı zamanı başvurusu derleme çözümlemesi sırasında aramak için konumları listesi.Daha önce listelenen yollarını aldığından önceliği sonraki girişleri yollarını bu listede görüntüleneceği sırayı anlamlı. |
AssemblyName |
Proje oluşturulduktan sonra son çıktı derlemenin adı. |
BaseAddress |
Temel adres ana çıkış derlemenin belirtir.Bu özellik eşdeğerdir /baseaddress derleyici anahtarı. |
BaseOutputPath |
Çıkış dosyası için temel yolunu belirtir.Bu ayarlanırsa, MSBuild kullanacağı OutputPath = $(BaseOutputPath)\$(Configuration)\.Örnek sözdizimi:<BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
BaseIntermediateOutputPath |
Tüm özel yapılandırma Ara Çıkış klasörleri oluşturulduğu en üst düzey klasör.Varsayılan değer obj\ şeklindedir.Aşağıdaki kod örneği verilmiştir:<BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
BuildInParallel |
Proje başvurularını yerleşik veya paralel zaman içinde Temizlenen olup olmadığını belirten bir boolean değeri birden çok işlemcide MSBuild kullanılır.Varsayılan değer true, birden çok çekirdekleri veya işlemciler olan, projeleri sistem içinde paralel if oluşturulacak anlamına gelir. |
BuildProjectReferences |
Proje başvurularını tarafından oluşturulmuş olup olmadığını belirten bir boolean değeri MSBuild.Ayarlanan false projenizi oluşturmak, Visual Studio tümleşik geliştirme ortamı (IDE) true , aksi takdirde. |
CleanFile |
"Temiz önbellek olarak." kullanılacak dosya adı Temiz önbellek temizleme işlemi sırasında silinecek oluşturulmuş dosyaları bir listesi verilmektedir.Dosya Ara çıkış yolunda yapı işlemi tarafından koyulur. Bu özellik, yol bilgileri olmayan dosya adını belirtir. |
Kod sayfası |
Derlemedeki tüm kaynak kodu dosyaları için kullanılacak kod sayfasını belirtir.Bu özellik eşdeğerdir /codepage derleyici anahtarı. |
CompilerResponseFile |
Derleyici görevlere geçirilen bir isteğe yanıt dosyası. |
Yapılandırma |
Oluşturduğunuz yapılandırma "Hata ayıklama" veya "Sürüm." |
CscToolPath |
Csc.exe, yolu Visual C# derleyici. |
CustomBeforeMicrosoftCommonTargets |
Bir proje dosyası veya otomatik olarak ortak hedefleri içe önce içeri hedef dosyanın adı. |
DebugSymbols |
Simgeleri yapı tarafından oluşturulan olup olmadığını belirten bir boolean değeri. Ayar /p:DebugSymbols=false komut satırında program veritabanı (.pdb) simge dosyaları nesil devre dışı bırakır. |
DefineConstants |
Koşullu derleyici sabitleri tanımlar.Simge/değer çiftleri noktalı virgülle ayrılmış ve aşağıdaki sözdizimini kullanarak belirtilen: symbol1 = değer1; Simge2 değer2 = Eşdeğer özelliktir /define derleyici anahtarı. |
DefineDebug |
Tanımlanan hata ayıklama sabiti isteyip istemediğinizi belirten bir boolean değeri. |
DefineTrace |
Tanımlanan izleme sabiti isteyip istemediğinizi belirten bir boolean değeri. |
DebugType |
Oluşturulan istediğiniz hata ayıklama bilgilerini düzeyini tanımlar.Geçerli değerler "tam," "pdbonly" ve "yok." |
DelaySign |
Tam oturum yerine gecikme işareti derleme istediğiniz olup olmadığını belirten bir boolean değeri. |
DisabledWarnings |
Belirtilen uyarıları göstermez.Uyarı tanımlayıcının yalnızca sayısal parçası belirtilmesi gerekir.Birden çok uyarıları noktalı virgülle ayrılmış.Bu parametre karşılık gelen /nowarn vbc.exe derleyici anahtarı. |
DisableFastUpToDateCheck |
Geçerli bir boolean değeri Visual Studio yalnızca.Visual Studio Bir proje, güncel olması için yeniden oluşturulması olup olmadığını belirlemek için FastUpToDateCheck adlı bir işlem yöneticisi kullanır oluşturun.Bu işlem kullanmaktan daha hızlı MSBuild bu belirlemek için.DisableFastUpToDateCheck özelliğini ayarlamak true geçiş sağlar Visual Studio Yöneticisi oluşturun ve kullanmak için zorlamak MSBuild proje güncel olup olmadığını belirlemek için. |
DocumentationFile |
XML belgeleri dosyası olarak oluşturulan dosyanın adı.Bu ad, yalnızca dosya adını içerir ve hiçbir yolu bilgiler içerir. |
ErrorReport |
Derleyici görev iç derleyici hatalarının nasıl rapor belirtir.Geçerli değerler "sor", "gönderme" veya "yok." Bu özellik eşdeğerdir /errorreport derleyici anahtarı. |
ExcludeDeploymentUrl |
GenerateDeploymentManifest Görevi Proje dosyası herhangi bir aşağıdaki öğeler içeriyorsa, dağıtım bildirimine deploymentProvider etiketi ekler:
ExcludeDeploymentUrl kullanarak, ancak, deploymentProvider etiketini yukarıdaki URL'lerin belirtilmiş olsa bile dağıtım bildirimine eklenmesini engelleyebilirsiniz. Bunu yapmak için proje dosyanızı aşağıdaki özelliği ekleyin: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl>
|
FileAlignment |
, Bayt cinsinden çıkış dosyası bölümlerine Hizala konumu belirtir.Geçerli değerler 512, 1024, 2048, 4096, 8192.Bu özellik eşdeğerdir /filealignment derleyici anahtarı. |
FrameworkPathOverride |
Mscorlib.dll ve Microsoft.VisualBasic.dll içinde konumunu belirtir.Bu parametre eşdeğerdir /sdkpath vbc.exe derleyici anahtarı. |
GenerateDocumentation |
Belge yapı tarafından oluşturulup oluşturulmayacağını belirten bir boolean parametresini.Varsa true, yapı belgeleri bilgileri oluşturur ve yürütülebilir dosya veya yapı görevi oluşturan kitaplık adı ile birlikte bir .xml dosyası içinde koyar. |
IntermediateOutputPath |
Elde edilen tam Ara çıkış yolu BaseIntermediateOutputPathyol belirtilmezse,.Örneğin, \obj\debug\.Bu özellik geçersiz kılınırsa, ardından ayarlar BaseIntermediateOutputPath etkisi yoktur. |
AnahtarKapsayıcıAdı |
Güçlü ad anahtar kapsayıcı adı. |
KeyOriginatorFile |
Güçlü ad anahtar dosyası adı. |
NoWin32Manifest |
Derleyici çıkış derlemeye Varsayılan Win32 bildirimini oluşturur olup olmadığını belirler.Varsayılan değeri false tüm uygulamalar için varsayılan Win32 bildirimini üretilir anlamına gelir.Bu özellik eşdeğerdir /nowin32manifest vbc.exe, derleyici anahtarı. |
ModuleAssemblyName |
Derlenen birleştirilir için modüldür derlemenin adı.Eşdeğer özelliktir /moduleassemblyname derleyici anahtarı. |
NoLogo |
Devre dışı bırakılmış için derleyici logosu isteyip istemediğinizi belirten bir boolean değeri.Bu özellik eşdeğerdir /nologo derleyici anahtarı. |
NoStdLib |
Standart Kitaplığı (mscorlib.dll) başvuran önlemek belirten bir boolean değeri.Varsayılan değer false şeklindedir. |
NoVBRuntimeReference |
Gösteren bir boolean değeri olup olmadığını Visual Basic çalışma zamanı (Microsoft.VisualBasic.dll içinde) projesi başvuru olarak dahildir. |
NoWin32Manifest |
Kullanıcı Hesabı Denetimi (UAC) bildirim bilgileri uygulamada katıştırılmış olup olmadığını belirten bir boolean değeri çalıştırılabilir.Yalnızca hedefleyen Visual Studio projeleri için geçerlidir Windows Vista.Kullanarak dağıtılan projelerinde ClickOnce ve kayıt ücretsiz COM, bu öğe göz ardı edilir. False kullanıcı hesabı denetimi (UAC) bildirim bilgileri uygulamanın yürütülebilir dosya içinde gömülü olması (varsayılan değer) belirtir.TrueUAC bildirim bilgileri değil gömülü olması belirtir. Bu özellik yalnızca için geçerlidir Visual Studio projeleri hedefleyen Windows Vista.Kullanarak dağıtılan projelerinde ClickOnce ve kayıt ücretsiz COM, bu özellik göz ardı edilir. Yalnızca size istemiyorsanız NoWin32Manifest eklemelisiniz Visual Studio herhangi bir bildirim katıştırılacak uygulamasında bilgilerini yürütülebilir; Bu işlem çağrılır sanallaştırma.Sanallaştırma kullanacak şekilde ayarlanmış <ApplicationManifest> ile birlikte <NoWin32Manifest> şekildedir:
|
En iyi duruma getirme |
Bir boolean değeri, ayarlandığında true, derleyici iyileştirmelerini sağlar.Bu özellik eşdeğerdir /optimize derleyici anahtarı. |
OptionCompare |
Dize karşılaştırmalarında nasıl yapılacağını belirtir.Geçerli değerler "ikili" veya "metin": Bu özellik eşdeğerdir /optioncompare vbc.exe, derleyici anahtarı. |
Option Explicit |
Bir boolean değeri, ayarlandığında true, kaynak kodundaki değişkenlerin açıkça bildirilmesini gerektirir.Bu özellik eşdeğerdir /optionexplicit derleyici anahtarı. |
OptionInfer |
Bir boolean değeri, ayarlandığında true, etkinleştirir değişkenlerin çıkarımı yazın.Bu özellik eşdeğerdir /optioninfer derleyici anahtarı. |
OptionStrict |
Bir boolean değeri, ayarlandığında true, örtük tür dönüştürme sınırlamak için sıkı tür semantiği zorlamak yapı görevin neden olur.Bu özellik eşdeğerdir /optionstrict vbc.exe derleyici anahtarı. |
OutputPath |
Örneğin, "bin\Debug" proje dizinine göre çıkış dizinin yolunu belirtir. |
OutputType |
Çıkış dosyası dosya biçimi belirtir.Bu parametre aşağıdaki değerlerden biri olabilir:
Bu özellik eşdeğerdir /target vbc.exe derleyici anahtarı. |
OverwriteReadOnlyFiles |
Salt okunur dosyaların üzerine veya bir hata tetiklemek yapı etkinleştirmek istediğiniz olup olmadığını belirten bir boolean değeri. |
PdbFile |
Yayma .pdb dosyasının dosya adı.Bu özellik eşdeğerdir /pdb csc.exe derleyici anahtarı. |
Platform |
İşletim sistemi için oluşturduğunuz.Geçerli değerler "Any CPU", "x 86" ve "x 64" şeklindedir. |
RemoveIntegerChecks |
Tamsayı taşması hata denetimleri devre dışı bırakılıp bırakılmayacağını gösteren bir boolean değeri.Varsayılan değer false şeklindedir.Bu özellik eşdeğerdir /removeintchecks vbc.exe derleyici anahtarı. |
SGenUseProxyTypes |
Proxy türleri SGen.exe tarafından oluşturulan olup olmadığını belirten bir boolean değeri. SGen hedef UseProxyTypes bayrağı ayarlamak için bu özelliği kullanır.Bu özellik true olarak Varsayılanları ve bu değeri değiştirmek için kullanıcı Arabirimi yoktur.Web hizmeti olmayan türleri için serileştirme derleme oluşturmak için bu özelliği proje dosyasına eklemek ve Microsoft.Common.Targets veya C#/VB.targets almadan önce false olarak ayarlanır. |
SGenToolPath |
Geçerli sürümü SGen.exe, geçersiz kılındığında SGen.exe elde etmek üzere yeri gösteren bir isteğe bağlı aracı yolu. |
StartupObject |
Sınıf veya ana yöntem veya alt ana yordam içeren modülü belirtir.Bu özellik eşdeğerdir /main derleyici anahtarı. |
ProcessorArchitecture |
Derleme başvuruları çözümlenen olduğunda kullanılır İşlemci mimarisi.Geçerli değerler "MSIL", "x 86," "amd64" veya "ia64." |
RootNamespace |
Katıştırılmış bir kaynak adı yapılırken kullanılacak kök ad alanı.Bu ad alanı katıştırılmış kaynak bildirim adı bir parçasıdır. |
Satellite_AlgorithmId |
Uydu derlemeleri oluşturulurken kullanılacak AL.exe karma algoritması kimliği. |
Satellite_BaseAddress |
Temel adres kültüre özgü uydu derlemeleri kullanılarak oluşturulan yapılırken kullanılacak CreateSatelliteAssemblies hedef. |
Satellite_CompanyName |
Uydu derleme oluşturma sırasında AL.exe geçirmek için şirket adı. |
Satellite_Configuration |
Uydu derleme oluşturma sırasında AL.exe geçirmek için yapılandırma adı. |
Satellite_Description |
Uydu derleme oluşturma sırasında AL.exe geçirmek için açıklama metin. |
Satellite_EvidenceFile |
Belirtilen dosya kaynak "Security.Evidence" adında derlemeyi katıştırır |
Satellite_FileVersion |
Dosya sürümü alanı için bir dize derlemeyi belirtir. |
Satellite_Flags |
Derlemeyi bayrak alanı için bir değer belirtir. |
Satellite_GenerateFullPaths |
Mutlak yollar bir hata iletisi raporlanan dosyalar için kullanılacak yapı görev neden olur. |
Satellite_LinkResource |
Belirtilen kaynak dosyaları bir derlemeyi bağlar. |
Satellite_MainEntryPoint |
Tam adı (yani, class.method) bir modül uydu derleme oluşturma sırasında bir yürütülebilir dosyaya dönüştürülen bir giriş noktası kullanılacak yöntemi belirtir. |
Satellite_ProductName |
Ürün alanı için bir dize derlemeyi belirtir. |
Satellite_ProductVersion |
ProductVersion alanı için bir dize derlemeyi belirtir. |
Satellite_TargetType |
Uydu derleme çıkış dosyasının dosya biçimi belirtir "kitaplık olarak," "exe" veya "kazanırsınız." Varsayılan değer ". kitaplığı": |
Satellite_Title |
Başlık alanı için bir dize derlemeyi belirtir. |
Satellite_Trademark |
Ticari marka alanı için bir dize derlemeyi belirtir. |
Satellite_Version |
Derlemeyi sürüm bilgilerini belirtir. |
Satellite_Win32Icon |
Bir .ico simge dosyası derlemeyi ekler. |
Satellite_Win32Resource |
Bir Win32 kaynak (.res dosyası) derlemeyi ekler. |
SubsystemVersion |
Oluşturulan yürütülebilir dosya kullanabilirsiniz alt sisteminin en düşük sürüm belirtir.Bu özellik eşdeğerdir /subsystemversion derleyici anahtarı.Bu özellik varsayılan değer hakkında daha fazla bilgi için bkz /subsystemversion (Visual Basic) veya /subsystemversion (C# Derleyici Seçenekleri). |
TargetCompactFramework |
Oluşturduğunuz uygulamayı çalıştırmak için gerekli .NET Compact Framework sürümü.Bu belirtme, aksi takdirde başvurmak erişemeyebilir belirli framework derlemeleri başvuru sağlar. |
TargetFrameworkVersion |
Sürümü .NET Framework , oluşturduğunuz uygulamayı çalıştırmak için gerekli.Bu belirtme, aksi takdirde başvurmak erişemeyebilir belirli framework derlemeleri başvuru sağlar. |
TreatWarningsAsErrors |
Bir boolean parametresini, varsa true, hata olarak kabul edilmesi tüm uyarıları neden olur.Bu parametre eşdeğerdir /nowarn derleyici anahtarı. |
UseHostCompilerIfAvailable |
Bir boolean parametresini, varsa true, kullanılabilir durumdaysa işlem içi derleyicisi nesnesini kullanmak yapı görevin neden olur.Bu parametre yalnızca tarafından kullanılan Visual Studio. |
Utf8Output |
Bir boolean parametresini, varsa true, derleyici çıktısını UTF-8 kodlama kullanılarak günlüğe kaydeder.Bu parametre eşdeğerdir /utf8Output derleyici anahtarı. |
VbcToolPath |
Geçerli sürümü vbc.exe, geçersiz kılındığında vbc.exe için başka bir konum belirten bir isteğe bağlı yolu. |
VbcVerbosity |
Ayrıntı düzeyini belirtir Visual Basic derleyici animasyonun çıktı.Geçerli değerler "Sessiz", "Normal" (varsayılan değer) veya "Ayrıntılı." |
VisualStudioVersion |
Visual Studio altında bu proje çalıştırması için değerlendirilip sürümünü belirtir.Bu özellik belirtilmezse, MSBuild için makul varsayılan bir değer ayarlar. Bu özellik, birkaç proje türü yapı için kullanılan hedefleri kümesini belirtmek için kullanılır.Varsa ToolsVersion 4.0 veya daha yüksek bir proje için ayarlanmışsa VisualStudioVersion hangi sub-kullanmak için bir araç takımı belirtmek için kullanılır.Daha fazla bilgi için bkz. MSBuild Araç Takımı (ToolsVersion). |
WarningsAsErrors |
Hata olarak işlemek için uyarılar listesini belirtir.Bu parametre eşdeğerdir /warnaserror derleyici anahtarı. |
WarningsNotAsErrors |
Hata olarak davranılır değil uyarılar listesini belirtir.Bu parametre eşdeğerdir /warnaserror derleyici anahtarı. |
Win32Manifest |
Son derlemede katıştırılmış bildirim dosyasının adı.Bu parametre eşdeğerdir /win32Manifest derleyici anahtarı. |
Win32Resource |
Son derlemede katıştırılacak Win32 kaynak dosya adı.Bu parametre eşdeğerdir /win32resource derleyici anahtarı. |