Ortak MSBuild Proje Özellikleri
Aşağıdaki tabloda sık kullanılan Visual Studio proje dosyalarında tanımlanan özellikleri veya MSBuild sağlayan .targets dosyasında bulunur.
Proje dosyalarını (.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. Projeler genellikle kendi yapı işlemi tanımlamak için bir veya daha fazla .targets dosyaları içe aktarın. Daha fazla bilgi için bkz. MSBuild.Hedefleri dosyaları.
Ortak özellikleri ve parametreler listesi
Özellik veya parametre adı |
Tanımlama |
|---|---|
AdditionalLibPaths |
Derleyiciler için başvuru derlemelerinin bakmanız gerekir ek klasörleri belirtir. |
AddModules |
Tüm tür hale getirmesine neden olan bilgileri belirtilen dosyaları derlediğiniz projede kullanılabilir. Bu özellik eşdeğerdir /addModules derleyici anahtarı. |
ALToolPath |
AL.exe bulunabileceği yolu. Bu özellik, geçerli sürümü farklı bir sürümü kullanımını etkinleştirmek için AL.exe geçersiz kılar. |
ApplicationIcon |
Win32 simge olarak gömmek için derleyiciye geçirmek .ico simge dosyası. Özellik eşdeğerdir /win32icon derleyici anahtarı. |
ApplicationManifest |
Kullanıcı Hesabı Denetimi (uac) dış bildirim bilgileri oluşturmak için kullanılan dosyanın yolunu belirtir. Yalnızca hedefleme Visual Studio projeleri için geçerlidir Windows Vista. Çoğu durumda, bildirim gömülüdür. Ancak, kayıt ücretsiz com kullanıyorsanız veya ClickOnce dağıtım ve bildirim, uygulama derlemeler ile birlikte yüklenen harici bir dosyası olabilir. Daha fazla bilgi için bu konudaki NoWin32Manifest özelliğine bakın. |
AssemblyOriginatorKeyFile |
İçin geçirilen ve derleme (.snk veya .pfx) imzalamak için kullanılan dosyayı belirtir ResolveKeySource görev derleme imzalamak için kullanılan gerçek anahtarı oluşturmak için. |
AssemblySearchPaths |
Yapı zamanı başvurusu derleme çözümlemesi sırasında Aranacak konumlar listesi. Daha önce listelenen yolları alır öncelik sonraki girişleri yollar bu listede görüntülendiği sırayı anlamlı olmasıdır. |
DerlemeAdı |
Proje oluşturulduktan sonra nihai çıktı derlemenin adı. |
BaseAddress |
Ana çıkış derleme taban adresini belirtir. Bu özellik eşdeğerdir /baseaddress derleyici anahtarı. |
BaseOutputPath |
Çıktı dosyası için temel yolu belirtir. Ayarlı ise, MSBuild kullanacağınız OutputPath = $(BaseOutputPath)\$(Configuration)\. Sözdizimi örneği görülmektedir:<BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
BaseIntermediateOutputPath |
En üst düzey klasör burada tüm özel yapılandırma Ara çıktı klasörler oluşturulur. obj\ varsayılan değerdir. Aşağıdaki kod örneği verilmiştir:<BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
BuildInParallel |
Proje başvurularını yerleşik veya temizlenen paralel zaman içinde olup olmadığını gösteren bir Boole değeri birden çok işlemcide MSBuild kullanılır. Varsayılan değer true, yani paralel if ifadesindeki sistemi oluşturulacak projeler birden çok çekirdek veya işlemci olan. |
BuildProjectReferences |
Proje başvuruları tarafından oluşturulmuş olup olmadığını gösteren bir Boole değeri MSBuild. Set false projenizi oluşturma, Visual Studio tümleşik geliştirme ortamı (IDE), true , aksi durumda. |
CleanFile |
"Temiz önbellek." kullanılacak dosyanın adını Temiz önbellek temizleme işlemi sırasında silinmek üzere oluşturulmuş dosyaları listesidir. Dosya Ara çıkış yolu yapı işlemi tarafından konur. Bu özellik yalnızca yol bilgisi olmayan dosya adları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örevler için geçirilen bir isteğe yanıt dosyası. |
Yapılandırma |
Oluşturmakta olduğunuz yapılandırma "Debug" veya "Yayın" |
CscToolPath |
Csc.exe, yol Visual C# derleyici. |
CustomBeforeMicrosoftCommonTargets |
Proje dosyasını veya otomatik olarak ortak hedefleri alma önce içeri hedef dosya adı. |
DebugSymbols |
Simgeleri bir yapı tarafından oluşturulan olup olmadığını gösteren bir Boole değeri. Ayarlama /p:DebugSymbols=false komut satırında program veritabanı (.pdb) simge dosyalarını oluşturma işlevini devre dışı bırakır. |
DefineConstants |
Koşullu derleme sabitleri tanımlar. Sembol/değer çiftleri noktalı virgüllerle ayrılmış ve aşağıdaki sözdizimi kullanılarak belirtilir: symbol1 = değer1; Simge2 = değer2 Özellik eşdeğerdir /define derleyici anahtarı. |
DefineDebug |
Hata ayıklama sabit tanımlı istediğiniz olup olmadığını belirten bir Boole değeri. |
DefineTrace |
İzleme sabitin tanımlı istediğiniz olup olmadığını belirten bir Boole değeri. |
DebugType |
Oluşturulan istediğiniz hata ayıklama bilgi düzeyini tanımlar. Geçerli değerler: "tam," "pdbonly" ve "yok." |
DelaySign |
Derleme gecikmeli imzala tam işareti yerine istediğiniz olup olmadığını gösteren bir Boole değeri. |
DisabledWarnings |
Belirtilen uyarılarını bastırır. Uyarı tanımlayıcının yalnızca sayısal parçasını belirtilmelidir. Birden çok uyarı noktalı virgüllerle ayrılır. Bu parametre karşılık gelen /nowarn vbc.exe derleyici anahtarı. |
DisableFastUpToDateCheck |
Geçerli bir Boole değeri Visual Studio yalnızca. Visual Studio Güncel olması için bir proje yeniden gerekir olup olmadığını belirlemek için FastUpToDateCheck adı verilen bir işlem Yöneticisi'ni kullanır oluşturmak. Bu işlem kullanmaktan daha hızlıdır MSBuild bunu belirlemek için. DisableFastUpToDateCheck özelliğini ayarlamak true atlamasına olanak tanır Visual Studio Yöneticisi oluşturmak ve kullanmak üzere zorla MSBuild projenin güncel olup olmadığını belirlemek için. |
DocumentationFile |
xml belgeleri dosyası oluşturulan dosyanın adıdır. Bu ad yalnızca dosya adı ve yol bilgisi yok sahiptir. |
ErrorReport |
Derleyici görev iç derleyici hatalarının nasıl raporlamalıdır belirtir. Geçerli değerler: "prompt" "Gönder" veya "none" Bu özellik eşdeğerdir /errorreport derleyici anahtarı. |
ExcludeDeploymentUrl |
GenerateDeploymentManifest görev Proje dosyası aşağıdaki öğelerden birini içeriyorsa, dağıtım bildirimine deploymentProvider etiketine ekler:
ExcludeDeploymentUrl kullanarak, ancak, deploymentProvider etiketini herhangi yukarıdaki URL'leri bile dağıtım bildirimine eklenmesini engelleyebilirsiniz. Bunu yapmak için aşağıdaki özellikler proje dosyanıza ekleyin: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> .gif "Not") Not
ExcludeDeploymentUrl açığa değil Visual Studio IDE ve yalnızca proje dosyasını el ile düzenleyerek ayarlayabilirsiniz. Bu özelliği ayarlamak içinde yayımlama etkilemez Visual Studio; diğer bir deyişle, PublishUrl tarafından belirtilen URL'ye deploymentProvider etiketini hala eklenecektir.
|
FileAlignment |
, Çıktı dosyası bölümlerini hizalamak nereye bayt cinsinden 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ğeri olan /sdkpath vbc.exe derleyici anahtarı. |
GenerateDocumentation |
Belge Yapı tarafından oluşturulup oluşturulmayacağını gösterir Boole parametresi. true, Yapı belgeleri bilgileri oluşturur ve yapı görevi oluşturan kitaplığı veya yürütülebilir dosya adıyla birlikte bir .xml dosyasına koyar. |
IntermediateOutputPath |
Türetilmiş tam Ara çıkış yolu BaseIntermediateOutputPathyol belirtilmezse,. Örneğin, \obj\debug\. Bu özelliği geçersiz kılınır, ardından ayarlar BaseIntermediateOutputPath hiçbir etkisi yoktur. |
KeyContainerName |
Kesin ad anahtar kapsayıcı adı. |
KeyOriginatorFile |
Kesin ad anahtar dosyası adı. |
NoWin32Manifest |
Derleyici çıktısı derlemeye Varsayılan Win32 bildirimini oluşturur olup olmadığını belirler. Varsayılan değer olan false tüm uygulamalar için varsayılan Win32 bildirimini oluşturulurken kullanılan anlamına gelir. Bu özellik eşdeğerdir /nowin32manifest vbc.exe, derleyici anahtarı. |
ModuleAssemblyName |
Derlenmiş modül birleştirilir derlemenin adı. Özellik eşdeğerdir /moduleassemblyname derleyici anahtarı. |
NoLogo |
Derleyici logo kapatılması için istediğiniz olup olmadığını belirten bir Boole değeri. Bu özellik eşdeğerdir /nologo derleyici anahtarı. |
NoStdLib |
Standart kitaplığa (mscorlib.dll) başvurudan kaçınmak iyi gösterir bir Boole değeri. false varsayılan değerdir. |
NoVBRuntimeReference |
Belirten bir Boole değeri olup olmadığını Visual Basic (Microsoft.VisualBasic.dll içinde) çalışma zamanı projedeki bir başvuru olarak dahil. |
NoWin32Manifest |
Kullanıcı Hesabı Denetimi (uac) bildirim bilgileri uygulamaya katıştırılan olup olmadığını gösteren bir Boole değeri yürütülebilir. Yalnızca hedefleme Visual Studio projeleri için geçerlidir Windows Vista. Kullanarak dağıtılan projelerinde ClickOnce ve Kayıtsız com, bu öğe göz ardı edilir. FalseKullanı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 hedefleme Windows Vista. Kullanarak dağıtılan projelerinde ClickOnce ve Kayıtsız com, bu özellik yoksayılır. Sadece değil istiyorsanız NoWin32Manifest eklemeniz gereken Visual Studio herhangi bir bildirim gömmek için bilgi uygulama yürütülebilir; Bu işlem adı verilen sanallaştırma. Sanallaştırma kullanmak için <ApplicationManifest> ile birlikte <NoWin32Manifest> aşağıdaki gibi:
|
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ı 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 kodda değişkenlerin açıkça bildirilmesini gerektirir. Bu özellik eşdeğerdir /optionexplicit derleyici anahtarı. |
OptionInfer |
Bir boolean değeri ayarlandığında, true, yazın değişkeni kesmesi etkinleştirir. Bu özellik eşdeğerdir /optioninfer derleyici anahtarı. |
OptionStrict |
Bir boolean değeri ayarlandığında, true, sıkı tür anlambilimini örtülü Tür dönüştürmeleri kısıtlamak yapı görevin neden olur. Bu özellik eşdeğerdir /optionstrict vbc.exe derleyici anahtarı. |
OutputPath |
Çıkış dizinine, "bin\Debug" proje dizinine göre yolu belirtir. |
OutputType |
Çıktı dosyasının dosya biçimini 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 isteyip istemediğinizi belirten bir Boole değeri. |
PdbFile |
Yayma .pdb dosyasının dosya adı. Bu özellik eşdeğerdir /pdb csc.exe derleyici anahtarı. |
Platform |
İçin oluşturmakta olduğunuz işletim sistemi. Geçerli değerler: "AnyCPU", "x 86" "x 64" veya "Itanium." |
RemoveIntegerChecks |
Bir Boole değeri tamsayı taşması hata denetimlerini devre dışı bırakılıp bırakılmayacağını belirtir. false varsayılan değerdir. Bu özellik eşdeğerdir /removeintchecks vbc.exe derleyici anahtarı. |
SGenUseProxyTypes |
Proxy türü SGen.exe tarafından üretilen belirten bir Boole değeri. Başvurusu SGen hedef UseProxyTypes bayrağını ayarlamak için bu özelliği kullanır. Bu özellik varsayılan olarak true değerine ve bunu değiştirmek için kullanıcı Arabirimi yoktur. Webservice türleri için seri hale getirme derlemesi üretmek için bu özellik proje dosyasına ekleyin ve Microsoft.Common.Targets veya C#/VB.targets almadan önce false olarak ayarlayın. |
SGenToolPath |
SGen.exe SGen.exe geçerli sürümünü geçersiz kılındığında nasıl edinileceğini isteğe bağlı araç yolu. |
StartupObject |
Sınıf veya Main yöntemi veya Sub Main yordamı içeren modül belirtir. Bu özellik eşdeğerdir /main derleyici anahtarı. |
ProcessorArchitecture |
Derleme başvuruları çözümlendiği, kullanılan işlemci mimarisi. Geçerli değerler: "MSIL", "x 86," "amd64" veya "ia64." |
RootNamespace |
Katıştırılmış bir kaynak adı, kullanılacak kök ad alanı. Bu ad alanı bildirimi katıştırılmış kaynak adı bir parçasıdır. |
Satellite_AlgorithmId |
Uydu derlemelerini oluşturulurken kullanılacak AL.exe karma algoritma kimliği. |
Satellite_BaseAddress |
Kültüre özgü uydu derlemelerini kullanarak oluşturulduklarında kullanılacak taban adresi CreateSatelliteAssemblies hedef. |
Satellite_CompanyName |
Uydu derleme oluşturma sırasında AL.exe aktarmak için şirket adı. |
Satellite_Configuration |
Uydu derleme oluşturma sırasında AL.exe aktarmak için yapılandırma adı. |
Satellite_Description |
Uydu derleme oluşturma sırasında AL.exe aktarmak için açıklama metni. |
Satellite_EvidenceFile |
Belirtilen dosya, kaynak adı "Security.Evidence" olan uydu derlemeye katıştırır. |
Satellite_FileVersion |
Uydu derlemesi içinde dosya sürüm alanı için bir dize belirtir. |
Satellite_Flags |
Uydu derlemesi içinde Bayrak alanı için bir değer belirtir. |
Satellite_GenerateFullPaths |
Mutlak yollar hata iletisinde bildirilen tüm dosyalar için kullanılacak yapı görevin neden olur. |
Satellite_LinkResource |
Belirtilen kaynak dosyaları bir uydu derlemeyi bağlar. |
Satellite_MainEntryPoint |
Tam nitelikli adını (class.method) modülü bir uydu derleme oluşturma sırasında bir yürütülebilir dosyaya dönüştürüldüğünde bir giriş noktası olarak kullanılacak yöntemi belirtir. |
Satellite_ProductName |
Uydu derlemesi içinde ürün alanı için bir dize belirtir. |
Satellite_ProductVersion |
Uydu derlemesi içinde ProductVersion alan için bir dize belirtir. |
Satellite_TargetType |
Uydu derleme çıktı dosyasının dosya biçimini belirtir ","Kitaplığı "exe" veya "kazanmak." "Kitaplık" varsayılan değerdir |
Satellite_Title |
Uydu derlemesi içinde başlık alanı için bir dize belirtir. |
Satellite_Trademark |
Uydu derlemesi içinde ticari marka alanı için bir dize belirtir. |
Satellite_Version |
Uydu derlemesi için sürüm bilgilerini belirtir. |
Satellite_Win32Icon |
Bir .ico simge dosyası uydu derlemesine ekler. |
Satellite_Win32Resource |
Bir Win32 kaynak (.res dosyası) uydu derlemesine ekler. |
SubsystemVersion |
Oluşturulan yürütülebilir dosyanın kullanabileceğiniz alt en düşük sürümünü belirtir. Bu özellik eşdeğerdir /subsystemversion derleyici anahtarı. Bu özelliğin varsayılan değeri hakkında daha fazla bilgi için bkz: /subsystemversion (Visual Basic) veya /subsystemversion (C# derleyicisi seçenekleri). |
TargetCompactFramework |
Oluşturmakta olduğunuz uygulama çalıştırmak için gereken .NET Compact Framework sürümü. Bu değişkenin belirtilmesi, aksi takdirde başvuru olmayabilir belirli framework derlemeleri başvuru sağlar. |
TargetFrameworkVersion |
Sürümü .NET Framework , oluşturduğunuz uygulamayı çalıştırmak için gerekli. Bu değişkenin belirtilmesi, aksi takdirde başvuru olmayabilir belirli framework derlemeleri başvuru sağlar. |
TreatWarningsAsErrors |
Boole parametresi, true, tüm uyarıları hata olarak kabul edilmesi neden olur. Bu parametre eşdeğeri olan /nowarn derleyici anahtarı. |
UseHostCompilerIfAvailable |
Boole parametresi, true, varsa işlem içi derleyicisi nesnesini kullanmak yapı görevin neden olur. Bu parametre yalnızca tarafından kullanılan Visual Studio. |
Utf8Output |
Boole parametresi, true, derleyici çıkışını utf-8 kodlamasını kullanarak kaydeder. Bu parametre eşdeğeri olan /utf8Output derleyici anahtarı. |
VbcToolPath |
Vbc.exe geçerli sürümünü geçersiz kılındığında vbc.exe için başka bir konum belirten isteğe bağlı bir yol. |
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'nun hangi koşullarda bu projeyi çalıştırması için düşünülmesi gereken sürümünü belirtir. Bu özellik belirlenmezse, MSBuild makul varsayılan değerine ayarlar. Bu özelliği birkaç proje türü oluşturma için kullanılan hedefleri kümesi belirtmek için kullanılır. ToolsVersion 4.0 Veya daha yüksek bir proje için ayarlanmış VisualStudioVersion kullanmak için hangi alt toolset belirtmek için kullanılır. Daha fazla bilgi için bkz. MSBuild Araç Takımı (ToolsVersion). |
WarningsAsErrors |
Uyarıları hata ele almasını listesini belirtir. Bu parametre eşdeğeri olan /warnaserror derleyici anahtarı. |
WarningsNotAsErrors |
Uyarıları hata olarak kabul edilmediği bir listesini belirtir. Bu parametre eşdeğeri olan /warnaserror derleyici anahtarı. |
Win32Manifest |
Son montaj içinde gömülü olması bildirimi dosyasının adı. Bu parametre eşdeğeri olan /win32Manifest derleyici anahtarı. |
Wint32Resource |
Son montaj içinde katıştırılmış Win32 kaynak dosyası adı. Bu parametre eşdeğeri olan /win32resource derleyici anahtarı. |