Sdílet prostřednictvím

Běžné položky projektu NÁSTROJE MSBuild

  • Článek

V nástroji MSBuild je položka pojmenovaným odkazem na jeden nebo více souborů. Položky obsahují metadata, jako jsou názvy souborů, cesty a čísla verzí. Všechny typy projektů v sadě Visual Studio mají několik společných položek. Tyto položky jsou definovány v souboru Microsoft.Build.CommonTypes.xsd.

Tento článek obsahuje seznam všech běžných položek projektu.

Reference

Představuje odkaz sestavení (spravovaný) v projektu.

Název metadat položky Popis
HintPath Volitelný řetězec. Relativní nebo absolutní cesta sestavení.
Jméno Volitelný řetězec. Zobrazovaný název sestavení, například System.Windows.Forms.
FusionName Volitelný řetězec. Určuje jednoduchý nebo silný sloučený název položky.

Pokud je tento atribut k dispozici, může ušetřit čas, protože soubor sestavení nemusí být otevřen, aby získal sloučený název.
SpecificVersion Volitelná logická hodnota Určuje, jestli se má odkazovat pouze na verzi v názvu fúzní syntézy.
Aliasy Volitelný řetězec. Všechny aliasy pro referenci
Soukromý Volitelná logická hodnota Určuje, jestli se má odkaz zkopírovat do výstupní složky. Tento atribut odpovídá vlastnosti Kopírovat místní odkazu v integrovaném vývojovém prostředí sady Visual Studio.

COMReference

Představuje odkaz na komponentu MODELU COM (nespravovaná) v projektu. Tato položka se vztahuje pouze na projekty .NET.

Název metadat položky Popis
Jméno Volitelný řetězec. Zobrazovaný název komponenty.
Identifikátor guid Povinný řetězec. Identifikátor GUID pro komponentu ve formuláři {12345678-1234-1234-1234-123456781234}.
VersionMajor Povinný řetězec. Hlavní část čísla verze komponenty. Například "5" pokud je celé číslo verze "5.46".
VersionMinor Povinný řetězec. Podverze čísla verze komponenty. Například "46" pokud je celé číslo verze "5.46".
EmbedInteropTypes Volitelná logická hodnota Pokud je pravda, vložte typy vzájemné spolupráce z tohoto odkazu přímo do sestavení místo generování knihovny DLL vzájemné spolupráce.
Lcid Volitelný řetězec. Národní prostředí pro komponentu.
WrapperTool Volitelný řetězec. Název nástroje obálky, který se používá v komponentě. Hodnoty jsou:

1. primární
2. tlbimp
3. primaryortlbimp
4. aximp
Izolovaný Volitelná logická hodnota Určuje, jestli je komponenta součástí bez regulárního výrazu.

COMFileReference

Představuje seznam knihoven typů, které se předávají parametru TypeLibFiles cíle ResolveComRefer ence. Tato položka se vztahuje pouze na projekty .NET.

Název metadat položky Popis
EmbedInteropTypes Volitelná logická hodnota Pokud je pravda, vložte typy vzájemné spolupráce z tohoto odkazu přímo do sestavení místo generování knihovny DLL vzájemné spolupráce.
WrapperTool Volitelný řetězec. Název nástroje obálky, který se používá v komponentě. Hodnoty jsou:

1. primární
2. tlbimp
3. primaryortlbimp
4. aximp

NativeReference

Představuje nativní soubor manifestu nebo odkaz na takový soubor.

Název metadat položky Popis
Jméno Povinný řetězec. Základní název souboru manifestu.
HintPath Povinný řetězec. Relativní cesta k souboru manifestu.

ProjectReference

Představuje odkaz na jiný projekt. ProjectReference položky jsou transformovány na Odkaz položky podle cíle ResolveProjectReferences, takže všechna platná metadata v odkazu můžou být platná pro ProjectReference, pokud proces transformace nepřepíše.

Název metadat položky Popis
Jméno Volitelný řetězec. Zobrazovaný název odkazu.
GlobalPropertiesToRemove Volitelné string[]. Názvy vlastností, které se mají odebrat při sestavování odkazovaného projektu, například RuntimeIdentifier;PackOnBuild. Výchozí hodnota je prázdná.
Projekt Volitelný řetězec. Identifikátor GUID pro odkaz ve formuláři {12345678-1234-1234-1234-123456781234}.
OutputItemType Volitelný řetězec. Typ položky, do které se mají vygenerovat cílové výstupy. Výchozí hodnota je prázdná. Pokud je metadata odkazu nastavena na true (výchozí), cílové výstupy se stanou odkazy pro kompilátor.
ReferenceOutputAssembly Volitelná logická hodnota Pokud je nastavená hodnota false, nezahrnuje výstup odkazovaného projektu jako odkazovaný odkaz tohoto projektu, ale přesto zajistí, aby se ostatní projekt sestavily před tímto projektem. Výchozí hodnota je true.
Soukromý Volitelná logická hodnota Určuje, jestli se má odkaz zkopírovat do výstupní složky. Tento atribut odpovídá vlastnosti Kopírovat místní odkazu v integrovaném vývojovém prostředí sady Visual Studio.
SetConfiguration Volitelný řetězec. Nastaví globální vlastnost Configuration pro odkazovaný projekt, například Configuration=Release.
SetPlatform Volitelný řetězec. Nastaví globální vlastnost Platform pro odkazovaný projekt, například Platform=AnyCPU.
SetTargetFramework Volitelný řetězec. Nastaví globální vlastnost TargetFramework pro odkazovaný projekt, například TargetFramework=netstandard2.0.
SkipGetTargetFrameworkProperties Volitelná logická hodnota Pokud true, sestaví odkazovaný projekt bez vyjednávání nejkomppatibilnější TargetFramework hodnoty. Výchozí hodnota je false.
Cíle Volitelné string[]. Středník oddělený seznam cílů v odkazovaných projektech, které by se měly sestavit. Výchozí hodnota je hodnota $(ProjectReferenceBuildTargets), která ve výchozím nastavení je prázdná, což označuje výchozí cíle. Při sestavování v sadě Visual Studio (na rozdíl od MSBuild.exe nebo dotnet build) nezabráníte sadě Visual Studio v vytváření výchozích cílů odkazovaného projektu.

Poznámka

Mezi fungováním odkazů na projekt mezi rozhraním .NET Framework a .NET Core (včetně .NET 5 a novějších) existuje rozdíl. Vprojektechch To znamená, že pokud Project1 odkazuje na Project2 a Project2 odkazuje na Project3, nemůžete kódovat v Projectu 3 z Projectu1. V .NET Core (včetně .NET 5 a novějších) jsou ale odkazy na projekty tranzitivní. V Projectu 1 můžete kódovat v Projectu 3.

Kompilovat

Představuje zdrojové soubory kompilátoru.

Název metadat položky Popis
DependentUpon Volitelný řetězec. Určuje soubor, na který tento soubor závisí správně zkompilovat.
AutoGen Volitelná logická hodnota Určuje, jestli byl soubor vygenerován pro projekt integrovaným vývojovými prostředími (IDE) sady Visual Studio.
Propojit Volitelný řetězec. Notační cesta, která se má zobrazit, když je soubor fyzicky umístěn mimo vliv souboru projektu.
Viditelný Volitelná logická hodnota Určuje, zda se má soubor zobrazit v průzkumníku řešení v sadě Visual Studio.
CopyToOutputDirectory Volitelný řetězec. Určuje, zda se má soubor zkopírovat do výstupního adresáře. Hodnoty jsou:

1. Nikdy
2. Vždy
3. PreserveNewest
4. IfDifferent

EmbeddedResource

Představuje prostředky, které se mají vložit do generovaného sestavení.

Název metadat položky Popis
Kultura Volitelný řetězec. Určuje jazykovou verzi souboru prostředku. Pokud je zadáno, proces sestavení nevyvozuje jazykovou verzi automaticky na základě přípony souboru (která závisí na jazykových verzích dostupných pro .NET/OS na počítači, který je hostitelem sestavení). Důrazně doporučujeme nastavit Culture={culture identifier} nebo metadata WithCulture=false.
WithCulture Volitelná logická hodnota. Určuje, že soubor je jazyková verze neutrální a detekce jazykové verze AssignCulture úloha by se měla přeskočit. Důrazně doporučujeme nastavit Culture={culture identifier} nebo metadata WithCulture=false.
DependentUpon Volitelný řetězec. Určuje soubor, na který tento soubor závisí správně zkompilovat.
Generátor Volitelný řetězec. Název libovolného generátoru souborů, který se spouští na této položce.
LastGenOutput Volitelný řetězec. Název souboru, který byl vytvořen jakýmkoli generátorem souborů, který běžel na této položce.
CustomToolNamespace Volitelný řetězec. Obor názvů, ve kterém by měl vytvořit kód libovolný generátor souborů, který běží na této položce.
Propojit Volitelný řetězec. Notační cesta se zobrazí, pokud je soubor fyzicky umístěn mimo vliv projektu.
Viditelný Volitelná logická hodnota Určuje, zda se má soubor zobrazit v průzkumníku řešení v sadě Visual Studio.
CopyToOutputDirectory Volitelný řetězec. Určuje, zda se má soubor zkopírovat do výstupního adresáře. Hodnoty jsou:

1. Nikdy
2. Vždy
3. PreserveNewest
4. IfDifferent
Logický název Povinný řetězec. Logický název vloženého prostředku.

Obsah

Představuje soubory, které nejsou kompilovány do projektu, ale mohou být vloženy nebo publikovány společně s ním.

Název metadat položky Popis
DependentUpon Volitelný řetězec. Určuje soubor, na který tento soubor závisí správně zkompilovat.
Generátor Volitelný řetězec. Název libovolného generátoru souborů, který běží na této položce.
LastGenOutput Volitelný řetězec. Název souboru, který byl vytvořen jakýmkoli generátorem souborů, který byl spuštěn na této položce.
CustomToolNamespace Volitelný řetězec. Obor názvů, ve kterém by měl vytvořit kód libovolný generátor souborů, který běží na této položce.
Propojit Volitelný řetězec. Notační cesta, která se má zobrazit, pokud je soubor fyzicky umístěn mimo vliv projektu.
PublishState Povinný řetězec. Stav publikování obsahu:

-Výchozí
-Zahrnutý
-Vyloučený
-Datafile
-Předpoklad
IsAssembly Volitelná logická hodnota Určuje, zda je soubor sestavení.
Viditelný Volitelná logická hodnota Určuje, zda se má soubor zobrazit v průzkumníku řešení v sadě Visual Studio.
CopyToOutputDirectory Volitelný řetězec. Určuje, zda se má soubor zkopírovat do výstupního adresáře. Hodnoty jsou:

1. Nikdy
2. Vždy
3. PreserveNewest
4. IfDifferent
TargetPath Volitelný řetězec. Výstupní cesta (vzhledem k výstupnímu adresáři specifickému pro konfiguraci nebo platformu) položky, včetně názvu souboru. To respektuje metadata Link, pokud jsou k dispozici. Pokud cílová cesta není k dispozici, vypočítá se během procesu sestavení. Viz AssignTargetPath.

Žádný

Představuje soubory, které by neměly mít v procesu sestavení žádnou roli.

Název metadat položky Popis
DependentUpon Volitelný řetězec. Určuje soubor, na který tento soubor závisí správně zkompilovat.
Generátor Volitelný řetězec. Název libovolného generátoru souborů, který se spouští na této položce.
LastGenOutput Volitelný řetězec. Název souboru, který byl vytvořen jakýmkoli generátorem souborů, který běžel na této položce.
CustomToolNamespace Volitelný řetězec. Obor názvů, ve kterém by měl vytvořit kód libovolný generátor souborů, který běží na této položce.
Propojit Volitelný řetězec. Notační cesta, která se má zobrazit, pokud je soubor fyzicky umístěn mimo vliv projektu.
Viditelný Volitelná logická hodnota Určuje, zda se má soubor zobrazit v průzkumníku řešení v sadě Visual Studio.
CopyToOutputDirectory Volitelný řetězec. Určuje, zda se má soubor zkopírovat do výstupního adresáře. Hodnoty jsou:

1. Nikdy
2. Vždy
3. PreserveNewest
4. IfDifferent

AssemblyMetadata

Představuje atributy sestavení, které mají být generovány jako [AssemblyMetadata(key, value)].

Název metadat položky Popis
Zahrnovat Stane se prvním parametrem (klíčem) v konstruktoru atributu AssemblyMetadataAttribute.
Hodnota Povinný řetězec. Stane se druhým parametrem (hodnotou) v konstruktoru atributu AssemblyMetadataAttribute.

Poznámka

Tato položka se vztahuje na projekty používající sadu SDK pro .NET 5 (a .NET Core) a novější verze.

InternalsVisibleTo

Určuje sestavení, která mají být generována jako [InternalsVisibleTo(..)] atributy sestavení.

Název metadat položky Popis
Zahrnovat Název sestavení.
Klíč Volitelný řetězec. Veřejný klíč sestavení.

Poznámka

Tato položka se vztahuje na projekty používající sadu SDK pro .NET 5 (a .NET Core) a novější verze.

BaseApplicationManifest

Představuje manifest základní aplikace pro sestavení a obsahuje informace o zabezpečení nasazení ClickOnce.

CodeAnalysisImport

Představuje projekt FxCop, který se má importovat.

Dovoz

Představuje sestavení, jejichž obory názvů by měly být importovány kompilátorem jazyka Visual Basic.

Složka

Tento prvek používá sada Visual Studio pouze jako zástupný symbol pro prázdnou složku. Při naplnění složky se nahradí jiným prvkem.

Viz také