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

  • Článek
  • 3 min ke čtení

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-1234567891234} .
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.
LCID 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 string[]Nepovinné . Názvy vlastností, které se mají odebrat při sestavování odkazovaného projektu, například RuntimeIdentifier;PackOnBuild . Výchozí hodnota je prázdná.
Project Volitelný řetězec. Identifikátor GUID pro odkaz ve tvaru {12345678-1234-1234-1234-1234567891234} .
OutputItemType Volitelný řetězec. Typ položky pro vysílání cílových výstupů. Výchozí hodnota je prázdná. Pokud je metadata odkazu nastavená na hodnotu true (výchozí), stanou se cílové výstupy odkazy na kompilátor.
ReferenceOutputAssembly Volitelná logická hodnota. Pokud je nastavená na , nezahrnuje výstup odkazovaného projektu jako odkaz na tento projekt, ale stále zajišťuje, že se druhý projekt sestaví false před tímto projektem. Výchozí hodnota je true .
Nastavení konfigurace Volitelný řetězec. Nastaví globální vlastnost Configuration odkazovaného projektu, například Configuration=Release .
Nastaveníplatformy 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í nejsvábilnější TargetFramework hodnoty. Výchozí hodnota je false .
Targets string[]Nepovinné . Středníkem oddělený seznam cílů v odkazovaných projektech, které by měly být sestaveny. Výchozí hodnota je $(ProjectReferenceBuildTargets) hodnota, u které je výchozí hodnota prázdná, což označuje výchozí cíle.

Kompilaci

Představuje zdrojové soubory pro kompilátor.

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.
AutoGen Volitelná logická hodnota. Určuje, jestli soubor vygeneroval pro projekt integrovaný vývojový Visual Studio (IDE).
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, 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ší

Vložený prostředek

Představuje prostředky, které chcete vložit do vygenerovaného 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 se zobrazí, 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ší
Logický_název Požadovaný ř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ím.

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ý běží na této položce.
LastGenOutput Požadovaný řetězec. Název souboru, který byl vytvořen generátorem souborů spuštěným u této položky.
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, která se má zobrazit, pokud je soubor fyzicky umístěný mimo vliv projektu.
PublishState Povinný řetězec. Stav publikování obsahu, a to buď:

– Výchozí
– Zahrnuto
– Vyloučené
– Datový datový
– Předpoklad
Sestavení Volitelná logická hodnota. Určuje, zda je soubor sestavením.
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

Žádné

Představuje soubory, které by neměly mít žádné role v procesu 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, která se má zobrazit, 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

AssemblyMetadata –

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

Název metadat položky Description
Zařadit členy Se bude první parametr (klíč) v AssemblyMetadataAttribute konstruktoru atributu.
Hodnota Povinný řetězec. Se bude druhým parametrem (hodnota) v AssemblyMetadataAttribute konstruktoru 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á mají být generována 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 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 Visual Basic kompilátorem.

Viz také