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 |
|---|---|
| Název | 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 |
|---|---|
| Název | 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 |
|---|---|
| Název | 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. 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 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 |
|---|---|
| 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. |
| 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í -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í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.