Obecné vlastnosti projektu nástroje MSBuild
V následující tabulce jsou uvedeny často používá vlastnosti, které jsou definovány v souborech projektu sady Visual Studio nebo zahrnuté v souborech TARGETS, které poskytuje MSBuild.
Soubory projektu v sadě Visual Studio (CSPROJ, vbproj, vcxproj a dalších) obsahovat kód MSBuild XML, která se spouští při sestavování projektu s použitím rozhraní IDE.Projekty obvykle importovat jeden nebo více souborů TARGETS definovat jejich proces sestavení.Další informace naleznete v tématu MSBuild – soubory .Targets.
Seznam běžných vlastností a parametrů
Vlastnost nebo název parametru |
Popis |
|---|---|
AdditionalLibPaths |
Určuje další složky, ve kterých má kompilátorů vyhledat odkaz na sestavení. |
AddModules |
Způsobí, že kompilátor tak, aby všechny typ informace ze zadaného soubory do projektu jsou kompilaci k dispozici.Tato vlastnost je ekvivalentem /addModules přepínače. |
ALToolPath |
Cesta, kde lze nalézt AL.exe.Tato vlastnost přepíše aktuální verzi AL.exe povolit používání různé verze. |
ApplicationIcon |
Soubor ikony ICO předávání kompilátoru pro vložení jako ikona Win32.Vlastnost je ekvivalentem /win32icon přepínače. |
ApplicationManifest |
Určuje cestu souboru, který se používá ke generování externího manifestu informace o účtu řízení Uživatelských účtů.Vztahuje se pouze k projektů sady Visual Studio cílené Windows Vista. Ve většině případů je vložený manifest.Nicméně pokud použijete volné COM registrace nebo ClickOnce nasazení a pak manifest může být externí soubor, který je nainstalován spolu s sestavení vaší aplikace.Další informace naleznete v tématu Vlastnost NoWin32Manifest v tomto tématu. |
AssemblyOriginatorKeyFile |
Určuje soubor, který se používá k podepsání sestavení (.snk nebo PFX) a která je předána ResolveKeySource – úloha ke generování skutečný klíč, který se používá k podepsání sestavení. |
AssemblySearchPaths |
Seznam umístění pro hledání během čas sestavení referenční sestavení řešení.Pořadí, ve kterém cesty se zobrazují v tomto seznamu je užitečné, vzhledem k tomu, že výše uvedené cesty přednost pozdější položky. |
AssemblyName |
Název sestavení závěrečný výstup po sestavení projektu. |
BaseAddress |
Určuje základní adresu hlavní výstupu sestavení.Tato vlastnost je ekvivalentem /baseaddress přepínače. |
BaseOutputPath |
Určuje základní cesta pro výstupní soubor.Pokud je nastavena, 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 specifické konfigurace středně pokročilý výstupní složky.Výchozí hodnota je obj\.Následující kód je příklad:<BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
BuildInParallel |
Logická hodnota, která označuje, zda jsou odkazy na projekt sestaven nebo čištění v paralelní při použití více procesorů 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 procesory. |
BuildProjectReferences |
Logická hodnota, která určuje, zda jsou odkazy na projekt sestavena podle MSBuild.Nastavit false Pokud vytváříte svůj projekt Visual Studio integrované vývojové prostředí (IDE), true -li jinak. |
CleanFile |
Název souboru, který bude použit jako "čisté mezipaměť." Je čistá mezipaměť seznam generovaných souborů, které mají být odstraněny během čisticí operace.Soubor je umístěn středně pokročilý výstupní cestě proces sestavení. Tato vlastnost určuje pouze názvy souborů, které nemají informace o cestě. |
Znaková stránka |
Určuje kód stránku má být použit pro všechny soubory zdrojového kódu při kompilaci.Tato vlastnost je ekvivalentem /codepage přepínače. |
CompilerResponseFile |
Soubor volitelné odpovědi, který může být předáno do kompilátoru úlohy. |
Konfigurace |
Konfigurace, které vytváříte, "Ladění" nebo "Verze." |
CscToolPath |
Cesta ke csc.exe, Visual C# kompilátoru. |
CustomBeforeMicrosoftCommonTargets |
Název souboru projektu nebo cíle soubor, který má být importována automaticky před importem společné cíle. |
DebugSymbols |
Logická hodnota, která určuje, zda symboly jsou generovány sestavení. Nastavení /p:DebugSymbols=false v příkazovém řádku zakáže generování souborů symbol programu databáze (PDB). |
DefineConstants |
Definuje konstanty podmíněného kompilátoru.Symbol/dvojice oddělených středníky a jsou určeny pomocí následující syntaxe: symbol1 = value1; symbol2 = value2 Vlastnost je ekvivalentem /define přepínače. |
DefineDebug |
Logická hodnota určující, zda chcete, aby konstantu DEBUG definované. |
DefineTrace |
Logická hodnota určující, zda chcete, aby konstanta trasování, která je definována. |
DebugType |
Definuje úroveň informace o ladění, který chcete, aby generované.Platné hodnoty jsou "celé," "pdbonly" a "žádná." |
DelaySign |
Logická hodnota určující, zda se má zpoždění podpis sestavení, nikoli plně přihlášení. |
DisabledWarnings |
Potlačí zadaných upozornění.Je nutné zadat pouze číselnou část identifikátoru upozornění.Více varování oddělených středníky.Tento parametr odpovídá /nowarn přepínače kompilátoru vbc.exe. |
DisableFastUpToDateCheck |
Logická hodnota, která se použije pro Visual Studio pouze.Visual Studio Sestavení manager používá proces nazývaný FastUpToDateCheck k určení, zda je třeba znovu vytvořit projekt, chcete-li být aktuální.Tento proces je rychlejší než použití MSBuild určí.Nastavením vlastnosti DisableFastUpToDateCheck na true umožňuje obejít Visual Studio vytvářet správce a vynutit používání MSBuild k určení, zda je aktuální projekt. |
DocumentationFile |
Název souboru, který je generován jako soubor XML dokumentace.Tento název obsahuje pouze název souboru a neobsahuje žádné informace o cestě. |
ErrorReport |
Určuje, jak má úloha kompilátoru ohlásit chyby interní kompilátoru.Platné hodnoty jsou prompt,""Odeslat"nebo"žádný. Tato vlastnost je ekvivalentem /errorreport přepínače. |
ExcludeDeploymentUrl |
GenerateDeploymentManifest – úloha Přidá deploymentProvider klíčové slovo k manifestu nasazení, je-li soubor projektu obsahuje následující prvky:
Pomocí ExcludeDeploymentUrl, však můžete zabránit značku deploymentProvider přidávané ke manifest nasazení i v případě, že jsou zadány jakékoli výše uvedené adresy URL. Chcete-li to provést, přidejte do souboru projektu následující vlastnost: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl>
|
FileAlignment |
Určuje v bajtech, kde má být zarovnat na části výstupní soubor.Platné hodnoty jsou 512, 1024, 2048, 4096, 8192.Tato vlastnost je ekvivalentem /filealignment přepínače. |
FrameworkPathOverride |
Určuje umístění mscorlib.dll a microsoft.visualbasic.dll.Tento parametr je ekvivalentem /sdkpath přepínače kompilátoru vbc.exe. |
GenerateDocumentation |
Parametr typu boolean, která určuje, zda dokumentace je generováno sestavení.Pokud true, sestavení generuje informace dokumentace a může se dostat do souboru XML spolu s názvem spustitelného souboru nebo knihovnu, která sestavení úloha vytvořena. |
IntermediateOutputPath |
Úplné středně pokročilý výstupní cestě odvozené z BaseIntermediateOutputPath, pokud není zadán žádná cesta.Například \obj\debug\.Pokud je tato vlastnost přepsána, pak nastavení BaseIntermediateOutputPath nemá žádný vliv. |
Kontejner_klíčů |
Název kontejneru klíčů silným názvem. |
KeyOriginatorFile |
Název souboru s klíčem silným názvem. |
NoWin32Manifest |
Určuje, zda kompilátor generuje výchozí Win32 manifest do výstupu sestavení.Výchozí hodnota false znamená, že výchozí Win32 manifest je vytvořen pro všechny aplikace.Tato vlastnost je ekvivalentem /nowin32manifest použitím přepínače vbc.exe. |
ModuleAssemblyName |
Název sestavení, který je kompilovaný modul mají být zahrnuty do.Vlastnost je ekvivalentem /moduleassemblyname přepínače. |
NoLogo |
Logická hodnota určující, zda chcete, aby kompilátor logo vypnout.Tato vlastnost je ekvivalentem /nologo přepínače. |
NoStdLib |
Logická hodnota určující, zda chcete-li předejít odkazované standardní knihovnu (mscorlib.dll).Výchozí hodnota je false. |
NoVBRuntimeReference |
Logická hodnota, která určuje, zda Visual Basic runtime (Microsoft.VisualBasic.dll), který má být zahrnuta jako odkaz v projektu. |
NoWin32Manifest |
Logická hodnota, která určuje, zda účet řízení Uživatelských účtů manifestu informace budou vloženy v aplikaci uživatele spustitelný soubor.Vztahuje se pouze k projektů sady Visual Studio cílené Windows Vista.V projektech, které jsou nasazeny pomocí ClickOnce a tento prvek-registrační COM je ignorováno. False (výchozí hodnota) určuje, že informace o účtu řízení Uživatelských účtů manifestu vloženy do spustitelného souboru aplikace.TrueUrčuje, že nebude vloženo manifestu informace o nástroji Řízení uživatelských účtů. Tato vlastnost se týká pouze Visual Studio projekty cílené Windows Vista.V projektech, které jsou nasazeny pomocí ClickOnce a -registrační COM tato vlastnost je ignorována. Měli byste přidat NoWin32Manifest pouze tehdy, pokud nechcete, aby Visual Studio k vložení jakýkoli manifest informace v aplikaci uživatele spustitelný; Tento proces se nazývá virtualization.Chcete-li použít virtualizace, nastavte <ApplicationManifest> ve spojení s <NoWin32Manifest> takto:
|
Optimalizace |
Logická hodnota, pokud je nastavena na true, umožňuje optimalizace kompilátoru.Tato vlastnost je ekvivalentem /optimize přepínače. |
OptionCompare |
Určuje, jak je prováděno porovnávání řetězce.Platné hodnoty jsou "binární" nebo "text". Tato vlastnost je ekvivalentem /optioncompare použitím 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 je ekvivalentem /optionexplicit přepínače. |
OptionInfer |
Logická hodnota, pokud je nastavena na true, umožňuje odvození proměnných typu.Tato vlastnost je ekvivalentem /optioninfer přepínače. |
OptionStrict |
Logická hodnota, pokud je nastavena na true, úlohu sestavení vynutit sémantika přísné typu omezení převody implicitní typu.Tato vlastnost je ekvivalentem /optionstrict přepínače kompilátoru vbc.exe. |
OutputPath |
Určuje cestu k adresáři výstupního vztahující se 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 je ekvivalentem /target přepínače kompilátoru vbc.exe. |
OverwriteReadOnlyFiles |
Logická hodnota určující, zda chcete povolit sestavení přepsat soubory jen pro čtení nebo aktivaci k chybě. |
PdbFile |
Název souboru PDB soubor, který jsou výstupu.Tato vlastnost je ekvivalentem /pdb přepínače kompilátoru csc.exe. |
Platforma |
Operační systém, který vytváříte pro.Platné hodnoty jsou "Libovolný procesor", "x 86" a "x 64". |
RemoveIntegerChecks |
Logická hodnota určující, zda má být zakázáno kontroly chyb přetečení celého čísla.Výchozí hodnota je false.Tato vlastnost je ekvivalentem /removeintchecks přepínače kompilátoru vbc.exe. |
SGenUseProxyTypes |
Logická hodnota určující, zda má proxy server typy generovaných SGen.exe. Cíl SGen tuto vlastnost používá k nastavení příznaku UseProxyTypes.Ve výchozím nastavení tato vlastnost na hodnotu true a neexistuje žádné uživatelské rozhraní toto nastavení lze změnit.Chcete-li generovat sestavení serializace pro typy jiný webová služba, přidejte tuto vlastnost na soubor projektu a nastavena na hodnotu false před importem Microsoft.Common.Targets nebo C#/VB.targets. |
SGenToolPath |
Cestu volitelné nástroje, která označuje, kde získat SGen.exe, pokud je aktuální verze SGen.exe přepsána. |
StartupObject |
Určuje třídu nebo modul, který obsahuje hlavní metoda nebo Sub hlavní procedury.Tato vlastnost je ekvivalentem /main přepínače. |
ProcessorArchitecture |
Architektura procesoru, která se používá v případě odkazů na sestavení jsou vyřešeny.Platné hodnoty jsou "msil," "x 86," "amd64" nebo "ia64." |
RootNamespace |
Kořenového oboru názvů pro použití při název integrovaného zdroje.Tento obor názvů je součástí názvu manifestu integrovaný prostředek. |
Satellite_AlgorithmId |
ID algoritmu hash AL.exe má použít při vytváření satelitních sestavení. |
Satellite_BaseAddress |
Základní adresa pro použití při specifických pro jazykovou verzi satelitní sestavení, které jsou vytvořeny pomocí CreateSatelliteAssemblies cíl. |
Satellite_CompanyName |
Název společnosti, která má být předán AL.exe během vytváření satelitních sestavení. |
Satellite_Configuration |
Název konfigurace má být předán AL.exe během vytváření satelitních sestavení. |
Satellite_Description |
Popis text, který má být předán AL.exe během vytváření satelitních sestavení. |
Satellite_EvidenceFile |
Vloží zadaný soubor do satelitního sestavení, které má název prostředku "Security.Evidence." |
Satellite_FileVersion |
Určuje řetězec pro pole verze souboru satelitního sestavení. |
Satellite_Flags |
Určuje hodnotu pole příznaky satelitního sestavení. |
Satellite_GenerateFullPaths |
Způsobí, že úloha sestavení používat absolutní cesty pro všechny soubory uvedeny v chybové zprávě. |
Satellite_LinkResource |
Zadaný zdroj soubory odkazy na satelitní sestavení. |
Satellite_MainEntryPoint |
Určuje plně kvalifikovaný název (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 pro pole produkt satelitního sestavení. |
Satellite_ProductVersion |
Určuje řetězec pro pole ProductVersion satelitního sestavení. |
Satellite_TargetType |
Určuje formát souboru výstupní soubor satelitní sestavení jako "library", "" exe"," nebo "vyhráli." Výchozí hodnota je "library." |
Satellite_Title |
Určuje řetězec pro pole názvu satelitního sestavení. |
Satellite_Trademark |
Určuje řetězec pro pole ochranné známky satelitního sestavení. |
Satellite_Version |
Určuje informace o verzi satelitního sestavení. |
Satellite_Win32Icon |
Vloží soubor ICO ikony satelitního sestavení. |
Satellite_Win32Resource |
Vloží prostředek Win32 (soubor .res) do satelitního sestavení. |
SubsystemVersion |
Určuje minimální verzi podsystému, který můžete použít generovaného spustitelný soubor.Tato vlastnost je ekvivalentem /subsystemversion přepínače.Informace o výchozí hodnotu této vlastnosti naleznete v tématu /subsystemversion (Visual Basic) nebo /subsystemversion (Možnosti kompilátoru C#). |
TargetCompactFramework |
Verze .NET Compact Framework potřebné ke spuštění aplikace, který vytváříte.Toto zadání umožňuje odkazovat určité framework sestavení, které nebudete moci odkazovat jinak. |
TargetFrameworkVersion |
Verzi .NET Framework , je nutné ke spuštění aplikace, který vytváříte.Toto zadání umožňuje odkazovat určité framework sestavení, které nebudete moci odkazovat jinak. |
TreatWarningsAsErrors |
Parametr typu boolean, pokud true, způsobí, že všechny upozornění jsou považovány za chyby.Tento parametr je ekvivalentem /nowarn přepínače. |
UseHostCompilerIfAvailable |
Parametr typu boolean, pokud true, způsobí, že úloha sestavení použití objektu v rámci procesu kompilátoru, pokud je k dispozici.Tento parametr slouží pouze Visual Studio. |
Utf8Output |
Parametr typu boolean, pokud true, protokoluje výstup kompilátoru pomocí kódování UTF-8.Tento parametr je ekvivalentem /utf8Output přepínače. |
VbcToolPath |
Volitelná cesta určující jiné umístění pro vbc.exe, pokud je aktuální verze vbc.exe přepsána. |
VbcVerbosity |
Určuje podrobností Visual Basic výstup kompilátoru.Platné hodnoty jsou "Tichém", "Normální" (výchozí hodnota) nebo "Podrobné." |
VisualStudioVersion |
Určuje verzi sady Visual Studio, pod kterou by měly být považovány tohoto projektu, aby byla spuštěna.Pokud není tato vlastnost zadána, nastaví jej MSBuild rozumné výchozí hodnotu. Tato vlastnost se používá v několik typů projekt k určení sadě cílů, které se používají pro sestavení.Pokud ToolsVersion je nastaven na 4.0 nebo vyšší projektu, VisualStudioVersion slouží k určení, které sub-sadu nástrojů používat.Další informace naleznete v tématu Sada nástrojů MSBuild (atribut ToolsVersion). |
WarningsAsErrors |
Určuje seznam upozornění považovat za chyby.Tento parametr je ekvivalentem /warnaserror přepínače. |
WarningsNotAsErrors |
Určuje seznam upozornění, která nejsou považovány za chyby.Tento parametr je ekvivalentem /warnaserror přepínače. |
Win32Manifest |
Název souboru manifestu, který má být vložen do konečné sestavení.Tento parametr je ekvivalentem /win32Manifest přepínače. |
Win32Resource |
Název souboru prostředek Win32, který má být vložena do konečné sestavení.Tento parametr je ekvivalentem /win32resource přepínače. |