Společné vlastnosti MSBuild projektu
V následující tabulce jsou uvedeny často používané vlastnosti, které jsou definovány v souborech projektu sady Visual Studio nebo zahrnuty v souborech TARGETS, které poskytuje nástroj MSBuild.
Soubory projektu v aplikaci Visual Studio (CSPROJ, vbproj, vcxproj a ostatní) obsahují kód XML nástroje MSBuild, která se spouští při vytvoření projektu pomocí rozhraní IDE.Projekty obvykle importovat jeden nebo více souborech TARGETS, chcete-li definovat jejich proces sestavení.Další informace naleznete v tématu Nástroj MSBuild.Soubory cíle.
Seznam běžných vlastností a parametrů
Vlastnost nebo název parametru |
Description |
---|---|
AdditionalLibPaths |
Určuje další složky, ve kterých by měl vypadat kompilátory pro odkaz na sestavení. |
AddModules |
Způsobí, že kompilátor, aby byl celý text informace ze zadané soubory projektu jsou kompilace.Tato vlastnost odpovídá /addModules přepínače kompilátoru. |
ALToolPath |
Cesta, kde lze nalézt AL.exe.Tato vlastnost přepíše aktuální verzi AL.exe povolit použití jiné verze. |
ApplicationIcon |
Soubor ICO ikony předat kompilátoru k vložení jako ikona Win32.Vlastnost je ekvivalentní /win32icon přepínače kompilátoru. |
ApplicationManifest |
Určuje cestu k souboru, který je používán ke generování externího manifestu informace nástroj Řízení uživatelských účtů (UAC).Platí pouze pro projekty aplikace Visual Studio cílení na Windows Vista. Ve většině případů je vložený manifest.Však používáte-li registraci zdarma COM nebo ClickOnce nasazení a manifestu může být externí soubor, který je nainstalován společně s sestavení vaší aplikace.Další informace naleznete v tématu Vlastnost NoWin32Manifest v tomto tématu. |
AssemblyOriginatorKeyFile |
Určuje soubor, který je použit k podepsání sestavení (.snk nebo PFX) a který je předán ResolveKeySource úloh Chcete-li generovat skutečný klíč, který je použit k podepsání sestavení. |
AssemblySearchPaths |
Seznam umístění hledání během vytváření odkazu sestavení řešení.Pořadí cesty v tomto seznamu má význam, protože výše uvedené cesty přednost novější položky. |
AssemblyName |
Název sestavení konečný výstup po sestavení projektu. |
Vlastnost BaseAddress |
Určuje základní adresu hlavního výstupu sestavení.Tato vlastnost odpovídá /baseaddress přepínače kompilátoru. |
BaseOutputPath |
Určuje základní cestu výstupního souboru.Pokud je nastaven, MSBuild použije OutputPath = $(BaseOutputPath)\$(Configuration)\.Příklad syntaxe:<BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
BaseIntermediateOutputPath |
Složku nejvyšší úrovně, kde jsou vytvořeny všechny mezilehlé výstup specifické konfigurace složky.Výchozí hodnota je obj\.Následující kód je uveden příklad:<BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
BuildInParallel |
Logická hodnota, která označuje, zda jsou odkazy na projekt sestaven nebo čištěny v paralelní při Multi-Proc MSBuild se používá.Výchozí hodnota je true, což znamená, že projekty bude vytvořen v paralelní, pokud systém s více jádry nebo procesorů. |
BuildProjectReferences |
Logická hodnota, která označuje, zda odkazy na projekt jsou vytvořeny podle MSBuild.Nastavit false v případě, že se sestavení projektu Visual Studio integrované vývojové prostředí (IDE), true -li jinak. |
CleanFile |
Název souboru, který bude použit jako "čisté mezipaměti." Čištění mezipaměti je seznam vygenerované soubory mají být odstraněny během operace čištění.Soubor je umístěn zprostředkující výstupní cestu v procesu sestavení. Tato vlastnost určuje pouze názvy souborů, které neobsahují informace o cestě. |
Znaková stránka |
Určuje znakovou stránku pro všechny soubory zdrojového kódu dané kompilace.Tato vlastnost odpovídá /codepage přepínače kompilátoru. |
CompilerResponseFile |
Volitelné odpověď souboru, který může být předán k úkolům kompilátor. |
Konfigurace |
Konfigurace, který vytváříte, "Ladění" nebo "Vydání". |
CscToolPath |
Cesta csc.exe, Visual C# kompilátoru. |
CustomBeforeMicrosoftCommonTargets |
Název souboru projektu nebo souboru cíle, které mají být importovány automaticky před importem společné cíle. |
DebugSymbols |
Logická hodnota, která označuje, zda jsou symboly generovaných sestavení. Nastavení /p:DebugSymbols=false v příkazovém řádku zakáže generování soubory symbolů (PDB) databáze programu. |
DefineConstants |
Definuje konstanty podmíněné kompilátoru.Dvojice symbolů a hodnoty jsou odděleny středníky a jsou určeny pomocí následující syntaxe: symbol1 = hodnota1; symbol2 = hodnota2 Vlastnost je ekvivalentní /define přepínače kompilátoru. |
DefineDebug |
Logická hodnota, která označuje, zda chcete, aby konstantu DEBUG, které jsou definovány. |
DefineTrace |
Logická hodnota, která označuje, zda chcete, aby konstantu TRACE definován. |
DebugType |
Definuje úroveň ladění informace generované.Platné hodnoty jsou "úplné," "pdbonly" a "žádný." |
DelaySign |
Logická hodnota, která označuje, zda se má opožděného podepsání sestavení, nikoli plně podepsat. |
DisabledWarnings |
Potlačí zobrazení zadaných upozornění.Musí být zadán pouze číselnou část identifikátoru upozornění.Více varování jsou odděleny středníky.Tento parametr odpovídá /nowarn přepínače kompilátoru vbc.exe. |
DisableFastUpToDateCheck |
Logická hodnota, která se vztahuje na Visual Studio pouze.Visual Studio Vytvořit správce používá proces nazývaný FastUpToDateCheck, chcete-li zjistit, zda projekt musí být znovu sestavovány jako aktuální.Tento proces je rychlejší než použití MSBuild určí.Nastavení vlastnosti DisableFastUpToDateCheck na true umožňuje obejít Visual Studio vytvořit správce a vynutit používání MSBuild Chcete-li zjistit, zda je aktuální projekt. |
DocumentationFile |
Název souboru, který je generován jako soubor dokumentace jazyka XML.Tento název zahrnuje pouze název souboru a neobsahuje žádné informace o cestě. |
ErrorReport |
Určuje, jak by měl kompilátor úkol ohlásit interních chybách kompilátoru.Platné hodnoty jsou "Výzva", "Odeslat" nebo "žádný." Tato vlastnost odpovídá /errorreport přepínače kompilátoru. |
ExcludeDeploymentUrl |
GenerateDeploymentManifest úloh Přidá značku deploymentProvider v manifestu nasazení, pokud soubor projektu obsahuje některý z následujících prvků:
Pomocí ExcludeDeploymentUrl, ale můžete zabránit značku deploymentProvider přidávané do manifestu nasazení, i v případě, že některý z výše uvedených adres URL jsou určeny. Chcete-li to provést, přidejte do souboru projektu následující vlastnosti: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> ![]()
ExcludeDeploymentUrl není vystavena v Visual Studio IDE a lze nastavit pouze ruční úpravou souboru projektu. Nastavení této vlastnosti nemá vliv na publikování ve Visual Studio; To znamená, že značku deploymentProvider stále přidávané adresu URL zadanou v PublishUrl.
|
FileAlignment |
Určuje, v bajtech, chcete-li zarovnat oddíly výstupního souboru.Platné hodnoty jsou 512, 1024, 2048, 4096, 8192.Tato vlastnost odpovídá /filealignment přepínače kompilátoru. |
FrameworkPathOverride |
Určuje umístění knihovny mscorlib.dll a knihovny microsoft.visualbasic.dll.Tento parametr je ekvivalentní /sdkpath přepínače kompilátoru vbc.exe. |
GenerateDocumentation |
Logický parametr, který označuje, zda je dokumentace generovaných sestavení.Pokud true, sestavení generuje informace o dokumentaci a vloží jej do souboru XML, jakož i název spustitelného souboru nebo knihovnu, kterou vytvořili úkol sestavení. |
IntermediateOutputPath |
Úplné zprostředkující výstupní cesta, odvozené z BaseIntermediateOutputPath, je-li zadána žádná cesta.Například \obj\debug\.Pokud je tato vlastnost přepsána, potom nastavení BaseIntermediateOutputPath nemá žádný vliv. |
Kontejner_klíčů |
Název kontejneru klíče silného názvu. |
KeyOriginatorFile |
Název souboru s klíčem silného názvu. |
NoWin32Manifest |
Určuje, zda kompilátor generuje výchozí Win32 manifest do výstupu sestavení.Výchozí hodnota false znamená, že pro všechny aplikace, je generována výchozí Win32 manifest.Tato vlastnost odpovídá /nowin32manifest kompilátor přepínače vbc.exe. |
ModuleAssemblyName |
Název sestavení, který je kompilovaný modul k tomu.Vlastnost je ekvivalentní /moduleassemblyname přepínače kompilátoru. |
NoLogo |
Logická hodnota, která označuje, zda chcete, aby kompilátor logo vypnuté.Tato vlastnost odpovídá /nologo přepínače kompilátoru. |
NoStdLib |
Logická hodnota, která označuje, zda se odkazuje na standardní knihovnu (mscorlib.dll).Výchozí hodnota je false. |
NoVBRuntimeReference |
Logická hodnota, která označuje, zda Visual Basic za běhu (Microsoft.VisualBasic.dll) by měla být zahrnuta jako odkaz v projektu. |
NoWin32Manifest |
Logická hodnota, která označuje, zda informace manifestu nástroj Řízení uživatelských účtů (UAC) budou vloženy do aplikace společnosti spustitelného souboru.Platí pouze pro projekty aplikace Visual Studio cílení na Windows Vista.V projektech, které jsou nasazeny pomocí ClickOnce a bez-registrační COM tento prvek je ignorována. False(výchozí hodnota) určuje, že nástroj Řízení uživatelských účtů (UAC) manifestu informace vloženy do spustitelného souboru dané aplikace.TrueUrčuje, že nebude vloženo informace manifestu nástroje Řízení uživatelských účtů. Tato vlastnost se vztahuje pouze na Visual Studio projekty, zaměření Windows Vista.V projektech, které jsou nasazeny pomocí ClickOnce a bez-registrační COM, tato vlastnost je ignorována. Měli byste přidat NoWin32Manifest pouze v případě, že nechcete, aby Visual Studio vložit jakýkoli manifest společnosti informace v aplikaci spustitelný; Tento proces se nazývá virtualizace.Nastavit virtualizaci, zadejte <ApplicationManifest> ve spojení s <NoWin32Manifest> takto:
|
Optimalizovat |
Logická hodnota, pokud je nastavena na true, povolí optimalizace kompilátoru.Tato vlastnost odpovídá /optimize přepínače kompilátoru. |
OptionCompare |
Určuje, jakým způsobem jsou k porovnávání řetězců.Platné hodnoty jsou "binární" nebo "text". Tato vlastnost odpovídá /optioncompare kompilátor přepínače vbc.exe. |
OptionExplicit |
Logická hodnota, pokud je nastavena na true, vyžaduje explicitní deklaraci proměnných ve zdrojovém kódu.Tato vlastnost odpovídá /optionexplicit přepínače kompilátoru. |
OptionInfer |
Logická hodnota, pokud je nastavena na true, umožňuje odvození proměnné typu.Tato vlastnost odpovídá /optioninfer přepínače kompilátoru. |
OptionStrict |
Logická hodnota, pokud je nastavena na true, způsobí, že úkol sestavení k vynucení sémantika přísné typu omezení implicitních převodech typů.Tato vlastnost odpovídá /optionstrict přepínače kompilátoru vbc.exe. |
OutputPath |
Určuje cestu k výstupnímu adresáři, relativně vzhledem k adresáři projektu, například "bin\Debug". |
OutputType |
Určuje formát souboru, výstupního souboru.Tento parametr může mít jednu z následujících hodnot:
Tato vlastnost odpovídá /target přepínače kompilátoru vbc.exe. |
OverwriteReadOnlyFiles |
Logická hodnota, která označuje, zda chcete povolit sestavení přepsat soubory určené jen pro čtení nebo aktivační událost k chybě. |
PdbFile |
Název souboru soubor .pdb, který se vysílá.Tato vlastnost odpovídá /pdb přepínače kompilátoru csc.exe. |
Platforma |
Operační systém, který vytváříte pro.Platné hodnoty jsou "AnyCPU", "x 86", "x 64" nebo "Itanium." |
RemoveIntegerChecks |
Logická hodnota označující, zda má být znepřístupněno chybové kontroly přetečení celých čísel.Výchozí hodnota je false.Tato vlastnost odpovídá /removeintchecks přepínače kompilátoru vbc.exe. |
SGenUseProxyTypes |
Logická hodnota, která označuje, zda typy proxy by měly být generovány SGen.exe. SGen cíl používá tuto vlastnost nastavit příznak UseProxyTypes.Výchozí nastavení této vlastnosti na hodnotu true a není k dispozici žádné uživatelské rozhraní, chcete-li toto nastavení změnit.Chcete-li generovat sestavení serializace pro typy bez webservice, přidat tuto vlastnost v souboru projektu a nastavena na hodnotu false před importem Microsoft.Common.Targets nebo C#/VB.targets. |
SGenToolPath |
Volitelný nástroj cesta označující, kde získat SGen.exe, je-li přepsat aktuální verzi SGen.exe. |
StartupObject |
Určuje třídu nebo modul, který obsahuje metodu Main nebo procedura Sub Main.Tato vlastnost odpovídá /main přepínače kompilátoru. |
ProcessorArchitecture |
Architektura procesoru používanou pro odkazy na sestavení, které jsou vyřešeny.Platné hodnoty jsou "jazyka msil," "x 86," "amd64" nebo "ia64." |
RootNamespace |
Kořenový obor názvů použijte v případě, že název integrovaného zdroje.Tento obor názvů je celý název vloženého prostředku manifestu. |
Satellite_AlgorithmId |
ID algoritmu hash AL.exe použít při vytváření satelitních sestavení. |
Satellite_BaseAddress |
Základní adresa při specifických pro jazykovou verzi satelitního sestavení, které jsou vytvořeny pomocí CreateSatelliteAssemblies cíl. |
Satellite_CompanyName |
Název společnosti, které lze předat do AL.exe během vytváření satelitních sestavení. |
Satellite_Configuration |
Název konfigurační průchod do AL.exe během vytváření satelitních sestavení. |
Satellite_Description |
Popisný text, který lze předat do AL.exe během vytváření satelitních sestavení. |
Satellite_EvidenceFile |
Vloží zadaný soubor satelitní sestavení, které má zdroj název "Security.Evidence." |
Satellite_FileVersion |
Určuje řetězec, který je v poli verze souboru satelitního sestavení. |
Satellite_Flags |
Určuje hodnotu pole příznaky satelitního sestavení. |
Satellite_GenerateFullPaths |
Způsobí, že úkol sestavení pomocí absolutní cesty pro všechny soubory uvedeny v chybové zprávě. |
Satellite_LinkResource |
Propojí určený prostředek soubory satelitního sestavení. |
Satellite_MainEntryPoint |
Určuje plně kvalifikovaný název (tj. class.method) metody, které chcete použít jako vstupní bod, když modul je převedena na spustitelný soubor během vytváření satelitních sestavení. |
Satellite_ProductName |
Určuje řetězec, který pole produkt satelitního sestavení. |
Satellite_ProductVersion |
Určuje řetězec pole ProductVersion satelitního sestavení. |
Satellite_TargetType |
Určuje formát souboru, výstupního souboru, satelitní sestavení jako "knihovna", "" exe"," nebo "mák." Výchozí hodnota je "library." |
Satellite_Title |
Určuje řetězec pro pole Title v satelitní sestavení. |
Satellite_Trademark |
Určuje řetězec, který je ochranná známka společnosti pole satelitního sestavení. |
Satellite_Version |
Určuje informace o verzi pro satelitní sestavení. |
Satellite_Win32Icon |
Vloží soubor .ico ikonu satelitního sestavení. |
Satellite_Win32Resource |
Prostředek systému Win32 (res souboru) se vloží do satelitního sestavení. |
SubsystemVersion |
Určuje minimální verzi podsystém, který pomocí generovaných spustitelného souboru.Tato vlastnost odpovídá /subsystemversion přepínače kompilátoru.Informace o výchozí hodnotu této vlastnosti naleznete v tématu /subsystemversion (Visual Basic) nebo /subsystemversion (C# volby kompilátoru). |
TargetCompactFramework |
Verze .NET Compact Framework, která je požadována ke spuštění aplikace, která vytváříte.Určení to umožňuje odkazovat na určité framework sestavení, které není možné odkazovat jinak. |
TargetFrameworkVersion |
Verze .NET Framework , je požadována ke spuštění aplikace, který vytváříte.Určení to umožňuje odkazovat na určité framework sestavení, které není možné odkazovat jinak. |
TreatWarningsAsErrors |
Booleovský parametr, pokud true, způsobí, že všechna upozornění považovány za chyby.Tento parametr je ekvivalentní /nowarn přepínače kompilátoru. |
UseHostCompilerIfAvailable |
Booleovský parametr, pokud true, způsobí úkol sestavení pomocí objektu vnitroprocesový kompilátor, pokud je k dispozici.Tento parametr se používá pouze Visual Studio. |
Utf8Output |
Booleovský parametr, pokud true, protokoluje výstup kompilátoru pomocí kódování UTF-8.Tento parametr je ekvivalentní /utf8Output přepínače kompilátoru. |
VbcToolPath |
Volitelná cesta, která označuje jiné umístění vbc.exe při přepsání aktuální verzi vbc.exe. |
VbcVerbosity |
Určuje podrobnost Visual Basic společnosti výstup kompilátoru.Platné hodnoty jsou "Tichý", "Normální" (výchozí hodnota) nebo "Verbose." |
VisualStudioVersion |
Určuje číslo verze aplikace Visual Studio, pod kterým tento projekt lze považovat běžet.Tato vlastnost není-li zadán, nástroj MSBuild jej nastaví přiměřené výchozí hodnotu. Tato vlastnost se používá v několika typech projektů k určení sady cílů, které se používají pro sestavení.Pokud ToolsVersion je nastavena na verzi 4.0 nebo vyšší pro projekt, VisualStudioVersion se používá k určení které toolset sub použití.Další informace naleznete v tématu Sada nástrojů MSBuild (atribut ToolsVersion). |
WarningsAsErrors |
Určuje seznam upozornění považovány za chyby.Tento parametr je ekvivalentní /warnaserror přepínače kompilátoru. |
WarningsNotAsErrors |
Určuje seznam upozornění, které nejsou považovány za chyby.Tento parametr je ekvivalentní /warnaserror přepínače kompilátoru. |
Win32Manifest |
Název souboru manifestu, který by měl být vložen do konečné sestavení.Tento parametr je ekvivalentní /win32Manifest přepínače kompilátoru. |
Wint32Resource |
Název souboru prostředků Win32, který má být vložen v konečném sestavení.Tento parametr je ekvivalentní /win32resource přepínače kompilátoru. |