Běžné vlastnosti projektu NÁSTROJE MSBuild
Následující tabulka uvádí často používané vlastnosti, které jsou definovány v souborech projektu sady Visual Studio nebo zahrnuty v .targets soubory, které nástroj MSBuild poskytuje.
Soubory projektu v sadě Visual Studio (.csproj, .vbproj, .vcxproja další) obsahují kód XML nástroje MSBuild, který se spustí při sestavování projektu pomocí integrovaného vývojového prostředí (IDE). Projekty obvykle importují jeden nebo více .targets soubory k definování procesu sestavení. Další informace naleznete v tématu MSBuild .targets soubory.
Při nastavování hodnot vlastností mějte na paměti, že běžné vlastnosti mohou být nastaveny, resetovány nebo použity v řadě importovaných souborů. Proto záleží na tom, kde nastavíte vlastnost - v souboru projektu, v Directory.Build.propsnebo v jiném importovaném souboru. Pokud někde nastavujete vlastnost a nezískáte očekávaný výsledek, zvažte, kde a jak se tato vlastnost změní nebo použije ve všech souborech importovaných vaším projektem, včetně importů, které se při použití atributu Sdk implicitně přidají. Viz Volba mezi přidáním vlastností do souboru .props nebo .targets. Předběžné zpracování vám může pomoct (viz /preprocess nebo možnost příkazového řádku /pp v odkaz na příkazový řádek MSBuild).
Seznam společných vlastností a parametrů
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| AdditionalLibPaths | .SÍŤ | Určuje další složky, ve kterých by kompilátory měly hledat referenční sestavení. |
| AddModules | .SÍŤ | Způsobí, že kompilátor zpřístupní všechny informace o typu ze zadaných souborů pro projekt, který kompilujete. Tato vlastnost je ekvivalentní přepínači kompilátoru /addModules. |
| ALToolPath | .SÍŤ | Cesta k AL.exe. Tato vlastnost přepíše aktuální verzi AL.exe, aby bylo možné používat jinou verzi. |
| ApplicationIcon | .SÍŤ | Soubor ikony .ico, který se má předat kompilátoru pro vložení jako ikona Win32. Vlastnost je ekvivalentní přepínači kompilátoru /win32icon. |
| ApplicationManifest | Všichni | Určuje cestu k souboru, který se používá k vygenerování informací o manifestu řízení uživatelských účtů (UAC). Platí pouze pro projekty sady Visual Studio, které cílí na Systém Windows Vista. Ve většině případů je manifest vložený. Pokud však používáte nasazení MODELU COM bez registrace nebo ClickOnce, může být manifest externím souborem, který je nainstalován společně se sestaveními vaší aplikace. Další informace naleznete v NoWin32Manifest vlastnost v tomto článku. |
| AssemblyOriginatorKeyFile | .SÍŤ | Určuje soubor použitý k podepsání sestavení (.snk nebo .pfx) a který se předá úloze ResolveKeySource k vygenerování skutečného klíče použitého k podepsání sestavení. |
| AssemblySearchPaths | .SÍŤ | Seznam umístění, která se mají vyhledat během řešení sestavení referenčního sestavení v době sestavení. Pořadí, ve kterém se cesty zobrazují v tomto seznamu, je smysluplné, protože cesty uvedené dříve mají přednost před pozdějšími položkami. |
| AssemblyName | .SÍŤ | Název konečného výstupního sestavení po sestavení projektu. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| BaseAddress | .SÍŤ | Určuje základní adresu hlavního výstupního sestavení. Tato vlastnost je ekvivalentní přepínači kompilátoru /baseaddress. |
| BaseIntermediateOutputPath | Všichni | Složka nejvyšší úrovně, kde jsou vytvořeny všechny výstupní složky specifické pro konfiguraci. Výchozí hodnota je obj\. Následující kód je příkladem: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
| BaseOutputPath | Všichni | Určuje základní cestu pro výstupní soubor. Pokud je nastavena, nástroj MSBuild používá OutputPath = $(BaseOutputPath)\$(Configuration)\. Příklad syntaxe: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
| BuildInParallel | Všichni | Logická hodnota, která označuje, zda jsou odkazy na projekty vytvořeny nebo vyčištěny paralelně při použití multi-Proc MSBuild. Výchozí hodnota je true, což znamená, že projekty budou sestaveny paralelně, pokud má systém více jader nebo procesorů. |
| BuildProjectReferences | Všichni | Logická hodnota, která označuje, zda jsou odkazy na projekt vytvořeny nástrojem MSBuild. Automaticky se nastaví na false, pokud projekt vytváříte v integrovaném vývojovém prostředí (IDE) sady Visual Studio, true pokud ne.
-p:BuildProjectReferences=false lze zadat na příkazovém řádku, aby se zabránilo kontrole aktuálního stavu odkazovaných projektů. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| CleanFile | Všichni | Název souboru, který se použije jako "čistá mezipaměť". Čistá mezipaměť je seznam vygenerovaných souborů, které se mají odstranit během operace čištění. Soubor se vloží do zprostředkující výstupní cesty procesem sestavení. Tato vlastnost určuje pouze názvy souborů, které nemají informace o cestě. |
| CodePage | .SÍŤ | Určuje znakovou stránku, která se má použít pro všechny soubory zdrojového kódu v kompilaci. Tato vlastnost je ekvivalentní přepínači kompilátoru /codepage. |
| CompilerResponseFile | .SÍŤ | Volitelný soubor odpovědi, který lze předat úlohě kompilátoru. |
| Konfigurace | Všichni | Konfigurace, kterou vytváříte, obecně Debug nebo Release, ale konfigurovatelná na úrovni řešení a projektu. |
| CscToolPath | C# | Cesta csc.exe, kompilátor jazyka C#. |
| CustomAfterMicrosoftCommonTargets | Všichni | Název souboru projektu nebo cílového souboru, který se má importovat automaticky po importu společných cílů. |
| CustomBeforeMicrosoftCommonTargets | Všichni | Název souboru projektu nebo cílí na soubor, který se má importovat automaticky před importem společných cílů. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| DebugSymbols | Všichni | Logická hodnota, která označuje, jestli jsou symboly generovány sestavením. Nastavení -p:DebugSymbols=false na příkazovém řádku zakáže generování souborů symbolů databáze programů (.pdb). |
| DebugType | Všichni | Definuje úroveň informací o ladění, které chcete vygenerovat. Platné hodnoty jsou "full", "pdbonly", "portable", "embedded" a "none". |
| DefineConstants | .SÍŤ | Definuje konstanty podmíněného kompilátoru. Dvojice symbolů a hodnot jsou oddělené středníky a jsou určeny pomocí syntaxe závislé na jazyce: C#: symbol1; symbol2Visual Basic: symbol1 = value1, symbol2 = value2Vlastnost je ekvivalentní přepínači kompilátoru /define. |
| DefineDebug | Všichni | Logická hodnota, která označuje, zda chcete definovat konstantu DEBUG. |
| DefineTrace | Všichni | Logická hodnota, která označuje, jestli chcete definovat konstantu TRACE. |
| DelaySign | .SÍŤ | Logická hodnota, která označuje, jestli chcete sestavení podepsat namísto úplného podepsání. |
| Deterministický | .SÍŤ | Logická hodnota, která označuje, zda kompilátor by měl vytvořit identická sestavení pro identické vstupy. Tento parametr odpovídá /deterministic přepínači kompilátorů. |
| DirectoryBuildPropsPath | Všichni | Určuje cestu k souboru Directory.Build.props; pokud je definovaná, tato vlastnost přepíše výchozí vyhledávací algoritmus. Viz Přizpůsobenísestavení . |
| DirectoryBuildTargetsPath | Všichni | Určuje cestu k souboru Directory.Build.targets; pokud je definovaná, tato vlastnost přepíše výchozí vyhledávací algoritmus. Viz Přizpůsobenísestavení . |
| DisableFastUpToDateCheck | Všichni | Logická hodnota, která se vztahuje pouze na Visual Studio. Správce sestavení sady Visual Studio používá proces s názvem FastUpToDateCheck k určení, zda musí být projekt znovu sestaven, aby byl aktuální. Tento proces je rychlejší než použití nástroje MSBuild k určení tohoto procesu. Nastavení DisableFastUpToDateCheck vlastnost na true umožňuje vynechat správce sestavení sady Visual Studio a vynutit jej, aby pomocí nástroje MSBuild určil, zda je projekt aktuální. |
| DocumentationFile | .SÍŤ | Název souboru, který se vygeneruje jako soubor dokumentace XML. Tento název zahrnuje pouze název souboru a neobsahuje žádné informace o cestě. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| ErrorReport | .SÍŤ | Určuje, jak má úloha kompilátoru hlásit vnitřní chyby kompilátoru. Platné hodnoty jsou "prompt", "send" nebo "none". Tato vlastnost je ekvivalentní přepínači kompilátoru /errorreport. |
| ExcludeDeploymentUrl | .SÍŤ | Úloha GenerateDeploymentManifest přidá do manifestu nasazení značku deploymentProvider, pokud soubor projektu obsahuje některý z následujících prvků: - UpdateUrl - InstallUrl - PublishUrl Pomocí rutiny ExcludeDeploymentUrl však můžete zabránit přidání značky deploymentProvider do manifestu nasazení, i když jsou zadány některé z výše uvedených adres URL. Uděláte to tak, že do souboru projektu přidáte následující vlastnost: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Poznámka: ExcludeDeploymentUrl není vystavený v integrovaném vývojovém prostředí sady Visual Studio a dá se nastavit pouze ruční úpravou souboru projektu. Nastavení této vlastnosti nemá vliv na publikování v sadě Visual Studio; to znamená, že značka deploymentProvider bude stále přidána do adresy URL určené publishUrl. |
| FileAlignment | .SÍŤ | Určuje, v bajtech, kde se mají zarovnat oddíly výstupního souboru. Platné hodnoty jsou 512, 1024, 2048, 4096, 8192. Tato vlastnost je ekvivalentní přepínači kompilátoru /filealignment. |
| FrameworkPathOverride | Visual Basic | Určuje umístění mscorlib.dll a microsoft.visualbasic.dll. Tento parametr odpovídá přepínači /sdkpath kompilátoru vbc.exe. |
| GenerateDocumentationFile | .SÍŤ | Logický parametr, který označuje, jestli je dokumentace generována sestavením. Pokud true, sestavení vygeneruje informace o dokumentaci a vloží je do souboru .xml společně s názvem spustitelného souboru nebo knihovny, kterou vytvořila úloha sestavení. |
| GenerateFullPaths | C# | Vygenerujte úplné cesty pro názvy souborů ve výstupu pomocí možnosti -fullpaths kompilátoru. |
| GenerateSerializationAssemblies | .SÍŤ | Určuje, zda mají být sestavení serializace XML generována SGen.exe, které lze nastavit na zapnuto, automaticky nebo vypnuto. Tato vlastnost se používá pro sestavení, která cílí pouze na rozhraní .NET Framework. Chcete-li generovat sestavení serializace XML pro sestavení .NET Standard nebo .NET Core, odkazujte na Microsoft.XmlSerializer.Generator balíček NuGet. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| ImportDirectoryBuildProps | Všichni | Logická hodnota označující, zda se má importovat soubor Directory.Build.props. Viz Přizpůsobenísestavení . |
| ImportDirectoryBuildTargets | Všichni | Logická hodnota, která označuje, jestli se má importovat soubor Directory.Build.targets. Viz Přizpůsobenísestavení . |
| IntermediateOutputPath | Všichni | Úplná zprostředkující výstupní cesta odvozená z BaseIntermediateOutputPath, pokud není zadána žádná cesta. Například obj\debug\. |
| KeyContainerName | Všichni | Název kontejneru klíče strong-name. |
| KeyOriginatorFile | Všichni | Název souboru klíče silného názvu. |
| ModuleAssemblyName | .SÍŤ | Název sestavení, do kterého se má zkompilovaný modul začlenit. Vlastnost je ekvivalentní přepínači kompilátoru /moduleassemblyname. |
| MSBuildProjectExtensionsPath | Všichni | Určuje cestu, kde se nacházejí rozšíření projektu. Ve výchozím nastavení má tato hodnota stejnou hodnotu jako BaseIntermediateOutputPath. |
| MsBuildTreatWarningsAsErrors | Všichni | Logická hodnota, která nástroji MSBuild říká, že má se všemi upozorněními zacházet jako s chybami, pokud nejsou potlačeny. |
| MsBuildWarningsAsErrors | Všichni | Určuje seznam kódů upozornění, které se mají považovat za chyby. Oddělte více upozornění středníky. Pokud používáte vlastnost .NET SDK WarningsAsErrors, MSBuildWarningsAsErrors výchozí hodnota WarningsAsErrors. |
| MSBuildWarningsAsMessages | Všichni | Určuje seznam kódů upozornění, které se mají potlačit tím, že je považují za zprávy s nízkou důležitostí. Oddělte více upozornění středníky. Všimněte si, že některá upozornění vygenerovaná nástrojem MSBuild nelze pomocí této vlastnosti potlačit; potlačte je pomocí přepínače příkazového řádku -warnAsMessage. Pokud používáte vlastnost .NET SDK NoWarn, MSBuildWarningsAsMessages výchozí hodnota NoWarn. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| NoLogo | Všichni | Logická hodnota, která označuje, jestli chcete vypnout logo kompilátoru. Tato vlastnost je ekvivalentní přepínači kompilátoru /nologo. |
| NoStdLib | .SÍŤ | Logická hodnota, která označuje, zda se chcete vyhnout odkazování na standardní knihovnu (mscorlib.dll). Výchozí hodnota je false. |
| NoVBRuntimeReference | Visual Basic | Logická hodnota, která označuje, zda má být modul runtime jazyka Visual Basic (Microsoft.VisualBasic.dll) zahrnut jako odkaz v projektu. |
| NoWarn | .SÍŤ | Potlačí zadaná upozornění. Je nutné zadat pouze číselnou část identifikátoru upozornění. Více upozornění jsou oddělena středníky. Tento parametr odpovídá /nowarn přepínači kompilátorů. |
| NoWin32Manifest | .SÍŤ | Logická hodnota, která označuje, jestli se informace o manifestu řízení uživatelských účtů (UAC) vloží do spustitelného souboru aplikace. Platí pouze pro projekty sady Visual Studio, které cílí na Systém Windows Vista. V projektech nasazených pomocí ClickOnce a Registration-Free modelu COM se tento prvek ignoruje.
False (výchozí hodnota) určuje, že informace o manifestu řízení uživatelských účtů (UAC) se vloží do spustitelného souboru aplikace.
True určuje, že informace manifestu řízení uživatelských účtů nejsou vloženy.Tato vlastnost se vztahuje pouze na projekty sady Visual Studio, které cílí na Systém Windows Vista. V projektech nasazených pomocí ClickOnce a Registration-Free MODELU COM se tato vlastnost ignoruje. NoWin32Manifest byste měli přidat pouze v případě, že nechcete, aby Visual Studio vkládal žádné informace o manifestu do spustitelného souboru aplikace; tento proces se nazývá virtualizace. Pokud chcete použít virtualizaci, nastavte <ApplicationManifest> ve spojení s <NoWin32Manifest> následujícím způsobem:– Pro projekty jazyka Visual Basic odeberte uzel <ApplicationManifest>. (V projektech jazyka Visual Basic se <NoWin32Manifest> ignoruje, pokud existuje uzel <ApplicationManifest>.)– U projektů jazyka C# nastavte <ApplicationManifest> na False a <NoWin32Manifest> na True. (V projektech C# <ApplicationManifest> přepsání <NoWin32Manifest>.)Tato vlastnost je ekvivalentní přepínač kompilátoru /nowin32manifestvbc.exe. |
| Optimalizovat | .SÍŤ | Logická hodnota, která při nastavení na trueumožňuje optimalizace kompilátoru. Tato vlastnost je ekvivalentní přepínači kompilátoru /optimize. |
| OptionCompare | VisualBasic | Určuje způsob porovnávání řetězců. Platné hodnoty jsou "binární" nebo "text". Tato vlastnost je ekvivalentní přepínač kompilátoru /optioncomparevbc.exe. |
| OptionExplicit | Visual Basic | Logická hodnota, která při nastavení na truevyžaduje explicitní deklaraci proměnných ve zdrojovém kódu. Tato vlastnost je ekvivalentní přepínači kompilátoru /optionexplicit. |
| OptionInfer | Visual Basic | Logická hodnota, která při nastavení na trueumožňuje odvozování typů proměnných. Tato vlastnost je ekvivalentní přepínači kompilátoru /optioninfer. |
| OptionStrict | Visual Basic | Logická hodnota, která při nastavení na true, způsobí, že úloha sestavení vynucuje striktní sémantiku typu omezit implicitní převody typů. Tato vlastnost odpovídá přepínači /optionstrict kompilátoru vbc.exe. |
| OutDir | Všichni | Označuje konečné umístění výstupu projektu nebo řešení. Při sestavování řešení lze OutDir použít ke shromáždění více výstupů projektu v jednom umístění. OutDir je navíc součástí AssemblySearchPaths, které slouží k překladu odkazů. Například bin\Debug. |
| Výstupní cesta | Všichni | Určuje cestu k výstupnímu adresáři vzhledem k adresáři projektu, například bin\Debug nebo bin\Debug\$(Platforma) v jiných sestaveních než AnyCPU. |
| OutputType | Všichni | Určuje formát souboru výstupního souboru. Tento parametr může mít jednu z následujících hodnot: -Knihovna. Vytvoří knihovnu kódu. (Výchozí hodnota.) - Exe. Vytvoří konzolovou aplikaci. -Modul. Vytvoří modul. - Winexe. Vytvoří program založený na systému Windows. Pro jazyk C# a Visual Basic je tato vlastnost ekvivalentní přepínači /target. Výstupní typ lze automaticky přepsat odvozením. Viz OutputType nastavený na WinExe pro aplikace WPF a WinForms. Zakažte odvozování nastavením DisableWinExeOutputInference na true. |
| PřepsáníReadOnlyFiles | Všichni | Logická hodnota, která označuje, jestli chcete povolit sestavení přepsat soubory jen pro čtení nebo aktivovat chybu. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| Mapa cesty | .SÍŤ | Určuje způsob mapování fyzických cest na názvy zdrojových cest výstupem kompilátoru. Tato vlastnost je ekvivalentní /pathmap přepínač kompilátorů. |
| PdbFile | .SÍŤ | Název souboru .pdb souboru, který generujete. Tato vlastnost odpovídá přepínači /pdb kompilátoru csc.exe. |
| Nástupiště | Všichni | Operační systém, pro který vytváříte. Příklady sestavení rozhraní .NET Framework jsou "Any CPU", "x86" a "x64". |
| ProcessorArchitecture | .SÍŤ | Architektura procesoru, která se používá při překladu odkazů na sestavení. Platné hodnoty jsou msil, x86, amd64 nebo ia64. |
| ProduceOnlyReferenceAssembly | .SÍŤ | Logická hodnota, která kompilátoru dává pokyn, aby vygeneroval pouze referenční sestavení místo zkompilovaného kódu. Nelze použít ve spojení s ProduceReferenceAssembly. Tato vlastnost odpovídá přepínači /refonly kompilátorů vbc.exe a csc.exe. |
| ProduceReferenceAssembly | .SÍŤ | Logická hodnota, která při nastavení na true umožňuje produkci referenčních sestavení pro aktuální sestavení.
Deterministic by při použití této funkce měly být true. Tato vlastnost odpovídá přepínači /refout kompilátorů vbc.exe a csc.exe. |
| RegisterAssemblyMSBuildArchitecture | Pouze Windows | Určuje výchozí architekturu, pro kterou je spravovaná knihovna DLL zaregistrovaná. Tato vlastnost je užitečná, protože com používá registr Systému Windows k uložení registrací v podregistrech specifických pro architekturu. Například v systému Windows může mít spravované sestavení AnyCPU své typy zaregistrované v 64bitovém podregistru nebo v 32bitovém podregistru (WoW) a sestavení používá tuto vlastnost k určení, které podregistry registru specifické pro architekturu použít. Platné hodnoty zahrnují "x86", "x64" a "ARM64". |
| RegisterForCOMInterop | Pouze Windows | Označuje, že spravovaná aplikace zveřejní objekt MODELU COM (obálku s možností volání modelu COM). Viz stránka Sestavení – oddíl Výstup. Toto nastavení má vliv jenom na počítač, na kterém se projekt sestavuje. Pokud nasazujete na jiné počítače, zavolejte regasm.exe a zaregistrujte sestavení na cílovém počítači. |
| RemoveIntegerChecks | Visual Basic | Logická hodnota, která označuje, jestli se mají zakázat kontroly chyb přetečení celého čísla. Výchozí hodnota je false. Tato vlastnost odpovídá přepínači /removeintchecks kompilátoru vbc.exe. |
| RootNamespace | Všichni | Kořenový obor názvů, který se má použít při pojmenování vloženého prostředku. Tento obor názvů je součástí názvu manifestu vloženého prostředku. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| Satellite_AlgorithmId | .SÍŤ | ID algoritmu hash AL.exe, který se má použít při vytváření satelitních sestavení. |
| Satellite_BaseAddress | .SÍŤ | Základní adresa, která se má použít při sestavování satelitních sestavení specifických pro jazykovou verzi pomocí cíle CreateSatelliteAssemblies. |
| Satellite_CompanyName | .SÍŤ | Název společnosti, který se má předat do AL.exe během generování satelitního sestavení. |
| Satellite_Configuration | .SÍŤ | Název konfigurace, který se má předat do AL.exe během generování satelitního sestavení. |
| Satellite_Description | .SÍŤ | Text popisu, který se má předat do AL.exe během generování satelitního sestavení. |
| Satellite_EvidenceFile | .SÍŤ | Vloží zadaný soubor do satelitního sestavení, který má název prostředku Security.Evidence. |
| Satellite_FileVersion | .SÍŤ | Určuje řetězec pro pole Verze souboru v satelitním sestavení. |
| Satellite_Flags | .SÍŤ | Určuje hodnotu pole Flags v satelitním sestavení. |
| Satellite_GenerateFullPaths | .SÍŤ | Způsobí, že úloha sestavení použije absolutní cesty pro všechny soubory hlášené v chybové zprávě. |
| Satellite_LinkResource | .SÍŤ | Spojí zadané soubory prostředků se satelitním sestavením. |
| Satellite_MainEntryPoint | .SÍŤ | Určuje plně kvalifikovaný název metody (tj. class.method), který se má použít jako vstupní bod při převodu modulu na spustitelný soubor během generování satelitního sestavení. |
| Satellite_ProductName | .SÍŤ | Určuje řetězec pro pole Product v satelitním sestavení. |
| Satellite_ProductVersion | .SÍŤ | Určuje řetězec pro pole ProductVersion v satelitním sestavení. |
| Satellite_TargetType | .SÍŤ | Určuje formát souboru výstupního souboru satelitního sestavení jako "library", "exe" nebo "win". Výchozí hodnota je "knihovna". |
| Satellite_Title | .SÍŤ | Určuje řetězec pole Název v satelitním sestavení. |
| Satellite_Trademark | .SÍŤ | Určuje řetězec pro pole Ochranné známky v satelitním sestavení. |
| Satellite_Version | .SÍŤ | Určuje informace o verzi satelitního sestavení. |
| Satellite_Win32Icon | .SÍŤ | Vloží soubor ikony .ico do satelitního sestavení. |
| Satellite_Win32Resource | .SÍŤ | Vloží do satelitního sestavení prostředek Win32 (soubor.res). |
| SGenToolPath | .SÍŤ | Volitelná cesta nástroje, která označuje, kde získat SGen.exe při přepsání aktuální verze SGen.exe. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| SGenUseProxyTypes | .SÍŤ | Logická hodnota označující, zda mají být typy proxy generovány SGen.exe. To platí pouze v případě, že GenerateSerializationAssemblies je nastaven na zapnuto. Cíl SGen používá tuto vlastnost k nastavení UseProxyTypes příznak. Tato vlastnost má výchozí hodnotu true a neexistuje žádné uživatelské rozhraní, které by toto nastavení změnilo. Chcete-li vygenerovat sestavení serializace pro jiné typy než webové služby, přidejte tuto vlastnost do souboru projektu a před importem Microsoft.Common.Targets nebo C#/VB.targets. |
| SkipInvalidConfigurations | Všichni | Při truevygenerujte upozornění na neplatné kombinace platformy a konfigurace, ale sestavení se nezdaří; při false nebo nedefinované (výchozí) vygenerujte chybu. |
| StartupObject | .SÍŤ | Určuje třídu nebo modul obsahující proceduru Main nebo Sub Main. Tato vlastnost je ekvivalentní přepínači kompilátoru /main. |
| SubsystemVersion | .SÍŤ | Určuje minimální verzi subsystému, který může vygenerovaný spustitelný soubor použít. Tato vlastnost je ekvivalentní přepínači kompilátoru /subsystemversion. Informace o výchozí hodnotě této vlastnosti naleznete v tématu /subsystemversion (Visual Basic) nebo /subsystemversion (možnosti kompilátoru jazyka C#). |
| TargetCompactFramework | .SÍŤ | Verze rozhraní .NET Compact Framework, která je nutná ke spuštění aplikace, kterou vytváříte. Zadáním této možnosti můžete odkazovat na určitá sestavení architektury, na která pravděpodobně nebudete moci odkazovat jinak. |
| TargetFrameworkVersion | .SÍŤ | Verze rozhraní .NET Framework, která se vyžaduje ke spuštění aplikace, kterou vytváříte. Zadáním této možnosti můžete odkazovat na určitá sestavení architektury, na která pravděpodobně nebudete moci odkazovat jinak. |
| TreatWarningsAsErrors | .SÍŤ | Logický parametr, který při truezpůsobí, že se všechna upozornění budou považovat za chyby. Tento parametr je ekvivalentní přepínači kompilátoru /nowarn. |
| UseCommonOutputDirectory | .SÍŤ | Logická vlastnost, kterou můžete nastavit na true, pokud chcete, aby všechny výstupy sestavení v řešení používaly stejný výstupní adresář. Pokud true, výstup odkazovaných projektů se nezkopíruje do projektů, které tyto závislosti používají, stejně jako obvykle v případě, že je toto nastavení false. Nastavení tohoto parametru na true nezmění skutečný výstupní adresář žádných projektů; Stále potřebujete nastavit výstupní adresář na požadovaný společný výstupní adresář pro každý projekt, který ho vyžaduje. |
| UseHostCompilerIfAvailable | .SÍŤ | Logický parametr, který pokud true, způsobí, že úloha sestavení použije objekt kompilátoru v procesu, pokud je k dispozici. Tento parametr používá pouze Visual Studio. |
| Utf8Output | .SÍŤ | Logický parametr, který při trueprotokoluje výstup kompilátoru pomocí kódování UTF-8. Tento parametr je ekvivalentní přepínači kompilátoru /utf8Output. |
| Název vlastnosti nebo parametru | Typy projektů | Popis |
|---|---|---|
| VbcToolPath | Visual Basic | Volitelná cesta označující jiné umístění pro vbc.exe při přepsání aktuální verze vbc.exe. |
| VbcVerbosity | Visual Basic | Určuje úroveň podrobností výstupu kompilátoru jazyka Visual Basic. Platné hodnoty jsou "Quiet", "Normal" (výchozí hodnota) nebo "Podrobné". |
| VisualStudioVersion | Všichni | Určuje verzi sady Visual Studio, ve které má být tento projekt považován za spuštěný. Pokud tato vlastnost není zadána, nástroj MSBuild ji nastaví na výchozí hodnotu {VisualStudioMajorVersion}.0; například bude 17.0 pro všechny verze sady Visual Studio 2022.Tato vlastnost se používá v několika typech projektů k určení sady cílů, které se používají pro sestavení. Pokud je ToolsVersion pro projekt nastavena na hodnotu 4.0 nebo vyšší, VisualStudioVersion slouží k určení, která dílčí sada nástrojů se má použít. Další informace naleznete v tématu Toolset (ToolsVersion). |
| WarningsAsErrors | .SÍŤ | Určuje seznam upozornění, která se mají považovat za chyby. Tento parametr je ekvivalentní přepínači kompilátoru /warnaserror. |
| WarningLevel | Všichni | Určuje úroveň upozornění, která se má předat kompilátorům pro upozornění vygenerované kompilátorem. Toto nastavení nemá vliv na upozornění nástroje MSBuild, která nemají označení na úrovni. Viz úroveň upozornění v dokumentaci kompilátoru jazyka C# a /W (úroveň upozornění) v dokumentaci kompilátoru jazyka C++. |
| UpozorněníNotAsErrors | .SÍŤ | Určuje seznam upozornění, která nejsou považována za chyby. Tento parametr je ekvivalentní přepínači kompilátoru /warnaserror. |
| Win32Manifest | .SÍŤ | Název souboru manifestu, který by měl být vložen do konečného sestavení. Tento parametr je ekvivalentní přepínači kompilátoru /win32Manifest. |
| Win32Resource | .SÍŤ | Název souboru prostředku Win32, který se má vložit do konečného sestavení. Tento parametr je ekvivalentní přepínači kompilátoru /win32resource. |
Vlastnosti specifické pro projekty sady .NET SDK, například TargetFramework, jsou zdokumentované ve vlastnostech rozhraní Framework.
Viz také
- běžné položky projektu MSBuild
- běžných metadat položek nástroje MSBuild
- rezervovaných a dobře známých vlastností nástroje MSBuild
- referenční dokumentace nástroje MSBuild pro projekty sady .NET SDK