Společné položky projektu nástroje MSBuild

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í.
Název 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
Privátní Volitelná logická hodnota Určuje, jestli se má odkaz zkopírovat do výstupní složky. Tento atribut odpovídá vlastnosti Copy Local odkazu, který je 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
Name Volitelný řetězec. Zobrazovaný název komponenty.
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ý režim 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 TypeLibFilescíle ResolveComReference . Tato položka se vztahuje pouze na projekty .NET.

Název metadat položky Popis
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
Name 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 do referenčních položek podle ResolveProjectReferences cíle, takže všechna platná metadata odkazu mohou být platná pro ProjectReference, pokud proces transformace nepřepíše.

Název metadat položky Popis
Name 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 odkaz na tento projekt, ale přesto zajistí, aby se ostatní sestavení projektu před tímto projektem. Výchozí hodnota trueje .
Privátní Volitelná logická hodnota Určuje, jestli se má odkaz zkopírovat do výstupní složky. Tento atribut odpovídá vlastnosti Copy Local odkazu, který je v integrovaném vývojovém prostředí sady Visual Studio.
SetConfiguration Volitelný řetězec. Nastaví globální vlastnost Configuration odkazovaného projektu, například Configuration=Release.
SetPlatform Volitelný řetězec. Nastaví globální vlastnost Platform odkazovaného projektu, například Platform=AnyCPU.
SetTargetFramework Volitelný řetězec. Nastaví globální vlastnost TargetFramework odkazovaného projektu, 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 falseje .
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.

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 však odkazy na projekty přechodné. 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.
Odkaz 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ík ř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

EmbeddedResource

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

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.
Odkaz 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ík ř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
LogicalName Povinný řetězec. Logický název vloženého prostředku.

Content

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.
Odkaz 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í
-Zahrnuty
- xcluded
-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ík ř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
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 Link metadata, pokud jsou k dispozici. Pokud cílová cesta není k dispozici, vypočítá se během procesu sestavení. Viz AssignTargetPath.

Nic

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.
Odkaz 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ík ř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

AssemblyMetadata

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

Název metadat položky Popis
Zahrnout Stane se prvním parametrem (klíčem) v konstruktoru AssemblyMetadataAttribute atributů.
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
Zahrnout 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.

Import

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é