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

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

V tomto článku jsou uvedeny všechny společné položky projektu.

Reference

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

Název metadat položky Description
Cestu Volitelný řetězec. Relativní nebo absolutní cesta k sestavení
Name Volitelný řetězec. Zobrazovaný název sestavení, například "System. Windows. Formuláře. "
Fusion Volitelný řetězec. Určuje jednoduchý nebo silný název fúze pro položku.

Pokud je tento atribut přítomen, může ušetřit čas, protože soubor sestavení není nutné otevřít, aby získal název fúze.
SpecificVersion Volitelná logická hodnota. Určuje, zda má být odkazována pouze verze v názvu fúze.
Aliasy Volitelný řetězec. Všechny aliasy pro referenci
Privátní Volitelná logická hodnota. Určuje, zda má být odkaz zkopírován do výstupní složky. tento atribut odpovídá vlastnosti Copy Local odkazu, který je v Visual Studio IDE.

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
Název Volitelný řetězec. Zobrazovaný název součásti.
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 součásti. Například "5", pokud je číslo úplné verze "5,46".
VersionMinor Povinný řetězec. Vedlejší část čísla verze součásti. Například "46", pokud je číslo úplné verze "5,46".
EmbedInteropTypes Volitelná logická hodnota. Je-li nastavena hodnota true, vložte typy spolupráce z tohoto odkazu přímo do sestavení namísto generování knihovny DLL pro spolupráci.
Identifikátory Volitelný řetězec. LocaleID pro komponentu
WrapperTool Volitelný řetězec. Název nástroje obálky, který se používá pro komponentu. Hodnoty jsou:

1. primární
2. Tlbimp
3. primaryortlbimp
4. Aximp
Isolated Volitelná logická hodnota. Určuje, zda je komponenta komponentou bez registrace.

COMFileReference

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

Název metadat položky Description
WrapperTool Volitelný řetězec. Název nástroje obálky, který se používá pro komponentu. 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
Název Povinný řetězec. Základní název souboru manifestu.
Cestu Povinný řetězec. Relativní cesta k souboru manifestu.

ProjectReference

Představuje odkaz na jiný projekt. ProjectReference položky jsou transformované na referenční položky podle ResolveProjectReferences cíle, takže jakákoli platná metadata na odkazu můžou být platná ProjectReference , pokud ho proces transformace nepřepíše.

Název metadat položky Popis
Název Volitelný řetězec. Zobrazovaný název odkazu
GlobalPropertiesToRemove Volitelné string[] . Názvy vlastností, které mají být odebrány při sestavování odkazovaného projektu, například RuntimeIdentifier;PackOnBuild . Výchozí hodnota je prázdná.
Project Volitelný řetězec. Identifikátor GUID odkazu ve formuláři {12345678-1234-1234-1234-123456781234} .
OutputItemType Volitelný řetězec. Typ položky, do které se mají generovat výstupy cíle Výchozí hodnota je prázdná. Pokud jsou referenční metadata nastavená na "true" (výchozí), budou se cílové výstupy nastavovat jako odkazy na kompilátor.
ReferenceOutputAssembly Volitelná logická hodnota. Pokud je nastaveno na false , nezahrnuje výstup odkazovaného projektu jako odkaz na tento projekt, ale stále zajišťuje, aby druhý projekt sestavil před tímto prvkem. trueVýchozí hodnota je.
SetConfiguration Volitelný řetězec. Nastaví globální vlastnost Configuration odkazovaného projektu, Configuration=Release například.
SetPlatform Volitelný řetězec. Nastaví globální vlastnost Platform odkazovaného projektu, Platform=AnyCPU například.
SetTargetFramework Volitelný řetězec. Nastaví globální vlastnost TargetFramework odkazovaného projektu, TargetFramework=netstandard2.0 například.
SkipGetTargetFrameworkProperties Volitelná logická hodnota. Pokud true , sestavení odkazovaného projektu se sestaví bez vyjednávání hodnoty nejvíce kompatibilního TargetFramework . falseVýchozí hodnota je.
Targets Volitelné string[] . Středníkem oddělený seznam cílů v odkazovaných projektech, které by měly být sestaveny. Výchozí hodnota je hodnota, jejíž výchozí hodnota $(ProjectReferenceBuildTargets) je prázdná, což značí výchozí cíle.

Sestavení

Představuje zdrojové soubory pro kompilátor.

Název metadat položky Description
DependentUpon Volitelný řetězec. Určuje soubor, na kterém je tento soubor závislý, aby se správně zkompiluje.
AutoGen Volitelná logická hodnota. určuje, zda byl soubor vygenerován pro projekt Visual Studio integrovaným vývojovým prostředím (IDE).
Odkaz Volitelný řetězec. Cesta k zápisu, která se má zobrazit, pokud je soubor fyzicky umístěný mimo vliv souboru projektu.
Viditelné Volitelná logická hodnota. určuje, zda se má v Visual Studio zobrazit soubor v Průzkumník řešení .
CopyToOutputDirectory Volitelný řetězec. Určuje, zda se má soubor zkopírovat do výstupního adresáře. Hodnoty jsou:

1. nikdy
2. vždycky
3. PreserveNewest

EmbeddedResource

Představuje prostředky, které mají být vloženy do generovaného sestavení.

Název metadat položky Description
DependentUpon Volitelný řetězec. Určuje soubor, na kterém je tento soubor závislý, aby se správně zkompiluje.
Generátor Povinný řetězec. Název jakéhokoli generátoru souborů, který je spuštěn na této položce.
LastGenOutput Povinný řetězec. Název souboru, který byl vytvořen generátorem souborů, který u této položky běžel.
CustomToolNamespace Povinný řetězec. Obor názvů, ve kterém má každý generátor souborů, který běží na této položce, vytvořit kód.
Odkaz Volitelný řetězec. Cesta k zápisu se zobrazí, pokud je soubor fyzicky umístěný mimo vliv projektu.
Viditelné Volitelná logická hodnota. určuje, zda se má v Visual Studio zobrazit soubor v Průzkumník řešení .
CopyToOutputDirectory Volitelný řetězec. Určuje, zda se má soubor zkopírovat do výstupního adresáře. Hodnoty jsou:

1. nikdy
2. vždycky
3. PreserveNewest
Logický operátor Povinný řetězec. Logický název vloženého prostředku.

Content

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

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

– Výchozí
- Zahrnuto
– Vyloučeno
– DataFile
– Požadavek
IsAssembly Volitelná logická hodnota. Určuje, zda je soubor sestavení.
Viditelné Volitelná logická hodnota. Určuje, jestli se má soubor zobrazit v Průzkumník řešení v Visual Studio.
CopyToOutputDirectory Volitelný řetězec. Určuje, jestli se má soubor zkopírovat do výstupního adresáře. Hodnoty jsou:

1. Nikdy
2. Vždy
3. Zachovat nejnovější

Žádné

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

Název metadat položky Description
DependentUpon (Závislí) Volitelný řetězec. Určuje soubor, na který tento soubor závisí, aby se správně zkompilil.
Generátor Požadovaný řetězec. Název generátoru souborů, který se spustí u této položky.
LastGenOutput Požadovaný řetězec. Název souboru vytvořeného generátorem souborů, který se s touto položkou spustili.
CustomToolNamespace Požadovaný řetězec. Obor názvů, ve kterém by měl jakýkoli generátor souborů, který běží na této položce, vytvořit kód.
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, jestli se má soubor zobrazit v Průzkumník řešení v Visual Studio.
CopyToOutputDirectory Volitelný řetězec. Určuje, jestli se má soubor zkopírovat do výstupního adresáře. Hodnoty jsou:

1. Nikdy
2. Vždy
3. Zachovat nejnovější

Metadata sestavení

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

Název metadat položky Description
Zařadit členy Stane se prvním parametrem (klíčem) v konstruktoru AssemblyMetadataAttribute atributu.
Hodnota Požadovaný řetězec. Stane se druhým parametrem (hodnotou) v konstruktoru AssemblyMetadataAttribute atributu.

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á se mají generovat jako [InternalsVisibleTo(..)] atributy sestavení.

Název metadat položky Description
Zařadit členy 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 základní manifest aplikace pro sestavení a obsahuje ClickOnce zabezpečení nasazení.

CodeAnalysisImport

Představuje projekt FxCop, který chcete importovat.

Import

Představuje sestavení, jejichž obory názvů by měl Visual Basic kompilátor.

Viz také