Sdílet prostřednictvím


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ů:

  • UpdateUrl

  • InstallUrl

  • PublishUrl

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>

PoznámkaPoznámka
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:

  • Pro Visual Basic odebrat projekty, <ApplicationManifest> uzlu.(V Visual Basic projekty, <NoWin32Manifest> je ignorována, pokud <ApplicationManifest> uzlu existuje.)

  • For Visual C# projects, set <ApplicationManifest> to False and <NoWin32Manifest> to True.(In Visual C# projects, <ApplicationManifest> overrides <NoWin32Manifest>.)

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:

  • Knihovna.Vytvoří knihovnu kódu.(Výchozí hodnota).

  • Exe.Vytvoří konzolovou aplikaci.

  • Modul.Vytvoří modul.

  • Winexe.Vytvoří program systému Windows.

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.

Viz také

Referenční dokumentace

Společný projekt MSBuild položky