Yaygın MSBuild proje özellikleri
Aşağıdaki tabloda, Visual Studio proje dosyalarında tanımlanan veya MSBuild'in sağladığı .targets dosyalarına dahil edilen sık kullanılan özellikler listelenmiştir.
Visual Studio'daki proje dosyaları (.csproj, .vbproj, .vcxproj ve diğerleri), IDE kullanarak bir proje oluşturduğunuzda çalıştırılan MSBuild XML kodunu içerir. Projeler genellikle derleme işlemlerini tanımlamak için bir veya daha fazla .targets dosyasını içeri aktarır. 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.props'da veya 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, özniteliğini kullanırken Sdk
ö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şvurusunda veya /pp
komut satırı seçeneğine bakın/preprocess
).
Ortak özelliklerin ve parametrelerin listesi
Özellik veya parametre adı | Proje türler | 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, derleyici anahtarına /addModules eşdeğerdir. |
ALToolPath | .NET | AL.exe yolu. 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 | .ico Win32 simgesi olarak eklemek üzere derleyiciye geçirilen simge dosyası. özelliği, derleyici anahtarına /win32icon 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 (.snk veya .pfx ) imzalamak için kullanılan ve derlemeyi imzalamak için kullanılan gerçek anahtarı oluşturmak üzere ResolveKeySource görevine geçirilen dosyayı belirtir. |
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ürler | Açıklama |
---|---|---|
BaseAddress | .NET | Ana çıkış derlemesinin temel adresini belirtir. Bu özellik, derleyici anahtarına /baseaddress 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 şudur: 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 kullanır OutputPath = $(BaseOutputPath)\$(Configuration)\ . Ö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 olan true , 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) true oluşturuyorsanız , aksi takdirde otomatik olarak olarak ayarlanırfalse . -p:BuildProjectReferences=false , başvuruda bulunılan projelerin güncel olup olmadığını denetlemekten kaçınmak için komut satırında belirtilebilir. |
Özellik veya parametre adı | Proje türler | 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, derleyici anahtarına /codepage eşdeğerdir. |
CompilerResponseFile | .NET | Derleyici görevlerine geçirilebilen isteğe bağlı bir yanıt dosyası. |
Yapılandırma | Tümü | Genel olarak Debug veya Release oluşturmakta olduğunuz ancak çözüm ve proje düzeylerinde yapılandırabileceğiniz yapılandırma. |
CscToolPath | C# | C# derleyicisi olan csc.exe yolu. |
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ürler | 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ı (.pdb) sembol 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, derleyici anahtarına /define 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 anahtarına karşılık gelir /deterministic . |
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ürler | 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, derleyici anahtarına /errorreport eşdeğerdir. |
ExcludeDeploymentUrl | .NET | Proje dosyasında aşağıdaki öğelerden herhangi biri varsa GenerateDeploymentManifest görevi dağıtım bildirimine bir deploymentProvider etiketi ekler: - 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, derleyici anahtarına /filealignment eşdeğerdir. |
FrameworkPathOverride | Visual Basic | mscorlib.dll ve microsoft.visualbasic.dll konumunu belirtir. Bu parametre, vbc.exe derleyicisinin anahtarına eşdeğerdir/sdkpath . |
GenerateDocumentationFile | .NET | Derleme tarafından belge oluşturulup oluşturulmadığını gösteren boole parametresi. isetrue , derleme 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.exe tarafı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ürler | 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, yolundan BaseIntermediateOutputPath tü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, derleyici anahtarına /moduleassemblyname eşdeğerdir. |
MSBuildProjectExtensionsPath | Tümü | Proje uzantılarının bulunduğu yolu belirtir. Varsayılan olarak, bu değer ile BaseIntermediateOutputPath 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. .NET SDK özelliğini WarningsAsErrors kullanıyorsanız, MSBuildWarningsAsErrors varsayılan olarak değerini WarningsAsErrors kullanır. |
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 komut satırı anahtarını -warnAsMessage kullanın. .NET SDK özelliğini NoWarn kullanıyorsanız, MSBuildWarningsAsMessages varsayılan olarak değerini NoWarn kullanır. |
Özellik veya parametre adı | Proje türler | Açıklama |
---|---|---|
NoLogo | Tümü | Derleyici logosunu kapatmak isteyip istemediğinizi gösteren boole değeri. Bu özellik, derleyici anahtarına /nologo 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 şudur: 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 anahtarına karşılık gelir /nowarn . |
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 Kayıtsız 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 KayıtSız 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ırma adı verilir. Sanallaştırmayı kullanmak için aşağıdakilerle <NoWin32Manifest> birlikte ayarlayın<ApplicationManifest> :- Visual Basic projeleri için düğümü kaldırın <ApplicationManifest> . (Visual Basic projelerinde, <NoWin32Manifest> bir <ApplicationManifest> düğüm mevcut olduğunda yoksayılır.)- C# projeleri için ve <NoWin32Manifest> olarak False True ayarlayın<ApplicationManifest> . (C# projelerinde<NoWin32Manifest> , <ApplicationManifest> geçersiz kılar.)Bu özellik, vbc.exe derleyici anahtarına eşdeğerdir /nowin32manifest . |
Optimize Et | .NET | olarak ayarlandığında true derleyici iyileştirmelerini etkinleştiren boole değeri. Bu özellik, derleyici anahtarına /optimize 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, vbc.exe derleyici anahtarına eşdeğerdir/optioncompare . |
OptionExplicit | Visual Basic | olarak ayarlandığında true kaynak koddaki değişkenlerin açık bildirimini gerektiren boole değeri. Bu özellik, derleyici anahtarına /optionexplicit eşdeğerdir. |
OptionInfer | Visual Basic | olarak ayarlandığında true değişkenlerin tür çıkarımına olanak tanıyan boole değeri. Bu özellik, derleyici anahtarına /optioninfer eşdeğerdir. |
OptionStrict | Visual Basic | olarak ayarlandığında true , 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, vbc.exe derleyicisinin anahtarına eşdeğerdir/optionstrict . |
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 anahtara /target eşdeğerdir. Çıkış türü çıkarılarak otomatik olarak geçersiz kılınabilir. Bkz . WPF ve WinForms uygulamaları için WinExe olarak ayarlanmış OutputType. olarak ayarlayarak DisableWinExeOutputInference çıkarımı true 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ürler | 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, csc.exe derleyicisinin anahtarına eşdeğerdir/pdb . |
Platform | 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. ile ProduceReferenceAssembly birlikte kullanılamaz. Bu özellik, vbc.exe ve csc.exe derleyicilerinin anahtarına karşılık gelir/refonly . |
ProduceReferenceAssembly | .NET | olarak ayarlandığında true geçerli derleme için başvuru derlemelerinin üretimini etkinleştiren boole değeri. Deterministic bu özelliği kullanırken olmalıdır true . Bu özellik, vbc.exe ve csc.exe derleyicilerinin anahtarına karşılık gelir/refout . |
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. Bkz . Derleme sayfası - Çıkış bölümü. 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 şudur: false . Bu özellik, vbc.exe derleyicisinin anahtarına eşdeğerdir/removeintchecks . |
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ürler | 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 hedef kullanılarak CreateSatelliteAssemblies 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ürler | Açıklama |
---|---|---|
SGenUseProxyTypes | .NET | Ara sunucu türlerinin SGen.exe tarafı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.targets içeri aktarmadan önce false olarak ayarlayın. |
SkipInvalidConfigurations | Tümü | olduğunda true , geçersiz platform ve yapılandırma bileşimleri üzerinde bir uyarı oluşturur, ancak derlemede başarısız olmaz; tanımlandığında veya tanımsız olduğunda false (varsayılan), bir hata oluşturur. |
StartupObject | .NET | Main yöntemini veya Sub Main yordamını içeren sınıfı veya modülü belirtir. Bu özellik, derleyici anahtarına /main 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, derleyici anahtarına /subsystemversion 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 | ise true tüm uyarıların hata olarak değerlendirilmesine neden olan boole parametresi. Bu parametre, derleyici anahtarına /nowarn eşdeğerdir. |
UseCommonOutputDirectory | .NET | Çözümdeki tüm derleme çıkışlarının aynı çıkış dizinini kullanmasını istediğinizde ayarlayabileceğiniz true boole özelliği. başvuruda true bulunan projelerin çıktısı bu bağımlılıkları kullanan projelere kopyalanmazsa, normalde bu ayar false olduğunda olduğu gibi. Bu parametrenin olarak true ayarlanması herhangi 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 | ise true 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 | ise true UTF-8 kodlaması kullanarak derleyici çıkışını günlüğe kaydeden boole parametresi. Bu parametre, derleyici anahtarına /utf8Output eşdeğerdir. |
Özellik veya parametre adı | Proje türler | 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 değerine {VisualStudioMajorVersion}.0 ayarlar; örneğin, Visual Studio 2022'nin tüm sürümleri için olacaktır 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 4,0 veya üzeri olarak ayarlanırsa ToolsVersion , VisualStudioVersion hangi alt araç takımının kullanılacağını belirtmek için kullanılır. Daha fazla bilgi için bkz . Araç Takımı (ToolsVersion). |
UyarılarAsErrors | .NET | Hata olarak ele alınacak uyarıların listesini belirtir. Bu parametre, derleyici anahtarına /warnaserror 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# derleyicisi belgelerinde Uyarı Düzeyi ve C++ derleyici belgelerinde /W (Uyarı düzeyi) bölümüne bakın. |
WarningsNotAsErrors | .NET | Hata olarak değerlendirilmez uyarıların listesini belirtir. Bu parametre, derleyici anahtarına /warnaserror eşdeğerdir. |
Win32Manifest | .NET | Son derlemeye katıştırılması gereken bildirim dosyasının adı. Bu parametre, derleyici anahtarına /win32Manifest eşdeğerdir. |
Win32Resource | .NET | Son derlemeye eklenecek Win32 kaynağının dosya adı. Bu parametre, derleyici anahtarına /win32resource eşdeğerdir. |
.NET SDK projelerine özgü özellikler( gibiTargetFramework
) Framework özellikleri sayfasında belgelenmiştir.