Gyakori MSBuild projektelemek
Az MSBuildben egy elem egy vagy több fájl nevesített hivatkozása. Az elemek metaadatokat, például fájlneveket, elérési utakat és verziószámokat tartalmaznak. A Visual Studio összes projekttípusa több elemet tartalmaz. Ezek az elemek a Microsoft.Build.CommonTypes.xsd fájlban vannak definiálva.
Ez a cikk felsorolja az összes gyakori projektelemet.
Reference
Szerelvény (felügyelt) referenciát jelöl a projektben.
| Elem metaadatainak neve | Leírás |
|---|---|
| HintPath | Nem kötelező sztring. A szerelvény relatív vagy abszolút elérési útja. |
| Név | Nem kötelező sztring. A szerelvény megjelenítendő neve, például"System.Windows.Forms". |
| FusionName | Nem kötelező sztring. Megadja az elem egyszerű vagy erős fúziós nevét. Ha ez az attribútum jelen van, időt takaríthat meg, mert a szerelvényfájlt nem kell megnyitni a fúziós név beszerzéséhez. |
| SpecificVersion | Nem kötelező logikai érték. Megadja, hogy csak a fúziós névben szereplő verzióra kell-e hivatkozni. |
| Aliasok | Nem kötelező sztring. A hivatkozás bármely aliasa. |
| Privát | Nem kötelező logikai érték. Megadja, hogy a hivatkozást át kell-e másolni a kimeneti mappába. Ez az attribútum megegyezik a Visual Studio IDE-ben található hivatkozás Helyi másolása tulajdonságával. |
COMReference
COM-összetevőhivatkozást (nem felügyelt) jelöl a projektben. Ez az elem csak .NET-projektekre vonatkozik.
| Elem metaadatainak neve | Leírás |
|---|---|
| Név | Nem kötelező sztring. Az összetevő megjelenítendő neve. |
| Guid | Kötelező sztring. Az összetevő GUID azonosítója {12345678-1234-1234-1234-123456781234}formában. |
| VersionMajor | Kötelező sztring. Az összetevő verziószámának fő része. Például "5" ha a teljes verziószám "5.46". |
| VersionMinor | Kötelező sztring. Az összetevő verziószámának kisebb része. Például "46", ha a teljes verziószám "5.46". |
| EmbedInteropTypes | Nem kötelező logikai érték. Ha igaz, ágyazza be az interop típusokat ebből a hivatkozásból közvetlenül a szerelvénybe ahelyett, hogy interop DLL-t hoz létre. |
| Lcid | Nem kötelező sztring. Az összetevő Területi azonosítója. |
| WrapperTool | Nem kötelező sztring. Az összetevőn használt burkolóeszköz neve. Az értékek a következők: 1. elsődleges 2. tlbimp 3. primaryortlbimp 4. aximp |
| Izolált | Nem kötelező logikai érték. Megadja, hogy az összetevő reg-free összetevő-e. |
COMFileReference
A TypeLibFiles cél paraméterének átadott típuskódtárak listáját jelöli. Ez az elem csak .NET-projektekre vonatkozik.
| Elem metaadatainak neve | Leírás |
|---|---|
| EmbedInteropTypes | Nem kötelező logikai érték. Ha igaz, ágyazza be az interop típusokat ebből a hivatkozásból közvetlenül a szerelvénybe ahelyett, hogy interop DLL-t hoz létre. |
| WrapperTool | Nem kötelező sztring. Az összetevőn használt burkolóeszköz neve. Az értékek a következők: 1. elsődleges 2. tlbimp 3. primaryortlbimp 4. aximp |
NativeReference
Natív jegyzékfájlt vagy egy ilyen fájlra mutató hivatkozást jelöl.
| Elem metaadatainak neve | Leírás |
|---|---|
| Név | Kötelező sztring. A jegyzékfájl alapneve. |
| HintPath | Kötelező sztring. A jegyzékfájl relatív elérési útja. |
ProjectReference
Egy másik projektre mutató hivatkozást jelöl.
ProjectReference elemeket a cél ResolveProjectReferences elemekké alakítja át, így a hivatkozások érvényes metaadatai érvényesek lehetnek ProjectReference, ha az átalakítási folyamat nem írja felül.
| Elem metaadatainak neve | Leírás |
|---|---|
| Név | Nem kötelező sztring. A hivatkozás megjelenítendő neve. |
| GlobalPropertiesToRemove | Nem kötelező string[]. A hivatkozott projekt létrehozásakor eltávolítandó tulajdonságok nevei, például RuntimeIdentifier;PackOnBuild. Alapértelmezés szerint üres. |
| Projekt | Nem kötelező sztring. A hivatkozás GUID azonosítója {12345678-1234-1234-1234-123456781234}formában. |
| OutputItemType | Nem kötelező sztring. Elemtípus, amelybe célkimeneteket szeretne kibocsátani. Az alapértelmezett érték üres. Ha a referencia-metaadatok értéke "true" (alapértelmezett), akkor a célkimenetek a fordító hivatkozásai lesznek. |
| ReferenceOutputAssembly | Nem kötelező logikai érték. Ha falseértékre van állítva, akkor nem tartalmazza a hivatkozott projekt kimenetét a projekt referencia, de továbbra is biztosítja, hogy a másik projekt a jelen projekt előtt épüljön fel. Alapértelmezés szerint true. |
| Privát | Nem kötelező logikai érték. Megadja, hogy a hivatkozást át kell-e másolni a kimeneti mappába. Ez az attribútum megegyezik a Visual Studio IDE-ben található hivatkozás Helyi másolása tulajdonságával. |
| SetConfiguration | Nem kötelező sztring. Beállítja a hivatkozott projekt globális tulajdonságának Configuration, például Configuration=Release. |
| SetPlatform | Nem kötelező sztring. Beállítja a hivatkozott projekt globális tulajdonságának Platform, például Platform=AnyCPU. |
| SetTargetFramework | Nem kötelező sztring. Beállítja a hivatkozott projekt globális tulajdonságának TargetFramework, például TargetFramework=netstandard2.0. |
| SkipGetTargetFrameworkProperties | Nem kötelező logikai érték. Ha true, a hivatkozott projektet a legkompatibilisebb TargetFramework érték egyeztetése nélkül hozza létre. Alapértelmezés szerint false. |
| Célok | Nem kötelező string[]. Pontosvesszővel elválasztott céllista a hivatkozott projektekben, amelyeket létre kell építeni. Az alapértelmezett érték a $(ProjectReferenceBuildTargets)értéke, amely alapértelmezés szerint üres, és az alapértelmezett célokat jelöli. Ha a Visual Studióban épít (szemben a MSBuild.exe vagy dotnet build), ennek megadása nem akadályozza meg, hogy a Visual Studio a hivatkozott projekt alapértelmezett céljait építse ki. |
Jegyzet
Különbség van a projekthivatkozások működése között a .NET-keretrendszer és a .NET Core között (beleértve a .NET 5-öt és újabb verziókat is). A .NET-keretrendszer projektjeiben a projekthivatkozások nem tranzitívak. Vagyis ha a Project1 a Project2-re hivatkozik, és a Project2 a Project3-ra hivatkozik, akkor a Project1-ből nem lehet a Project3-ra kódokat kódot beállítani. A .NET Core-ban (beleértve a .NET 5-öt és újabb verziót is) azonban a projekthivatkozások tranzitívak. A Project1-ben a Project3-ban kódokat használhat.
Összeállít
A fordító forrásfájljait jelöli.
| Elem metaadatainak neve | Leírás |
|---|---|
| DependentUpon | Nem kötelező sztring. Azt a fájlt adja meg, amelytől a fájl a megfelelő fordítástól függ. |
| AutoGen | Nem kötelező logikai érték. Azt jelzi, hogy a fájlt a Visual Studio integrált fejlesztési környezete (IDE) hozta-e létre a projekthez. |
| Láncszem | Nem kötelező sztring. Az a jelölési útvonal, amely akkor jelenik meg, ha a fájl fizikailag a projektfájl hatásán kívül helyezkedik el. |
| Látható | Nem kötelező logikai érték. Azt jelzi, hogy meg szeretné-e jeleníteni a fájlt Megoldáskezelő a Visual Studióban. |
| CopyToOutputDirectory | Nem kötelező sztring. Meghatározza, hogy a fájlt a kimeneti könyvtárba szeretné-e másolni. Az értékek a következők: 1. Soha 2. Mindig 3. PreserveNewest 4. IfDifferent |
EmbeddedResource
A létrehozott szerelvénybe beágyazandó erőforrásokat jelöli.
| Elem metaadatainak neve | Leírás |
|---|---|
| Kultúra | Nem kötelező sztring. Az erőforrásfájl kulturális környezetét adja meg. Ha meg van adva, a buildelési folyamat nem tudja automatikusan kikövetkeztetni a kultúrát a fájlkiterjesztés alapján (amely a buildet üzemeltető gépen a .NET/OS számára elérhető kultúráktól függ). A metaadatok Culture={culture identifier} vagy WithCulture=false beállítása erősen ajánlott. |
| WithCulture | Nem kötelező bool. Azt határozza meg, hogy a fájl kultúrasemleges, és a AssignCulture feladat által végzett kultúraészlelést ki kell hagyni. A metaadatok Culture={culture identifier} vagy WithCulture=false beállítása erősen ajánlott. |
| DependentUpon | Nem kötelező sztring. Azt a fájlt adja meg, amelytől a fájl a megfelelő fordítástól függ |
| Generátor | Nem kötelező sztring. Az elemen futó fájlgenerátor neve. |
| LastGenOutput | Nem kötelező sztring. Az elemen futtatott bármely fájlgenerátor által létrehozott fájl neve. |
| CustomToolNamespace | Nem kötelező sztring. Az a névtér, amelyben az elemen futó bármely fájlgenerátornak létre kell hoznia a kódot. |
| Láncszem | Nem kötelező sztring. A jelölési útvonal akkor jelenik meg, ha a fájl fizikailag a projekt hatásán kívül található. |
| Látható | Nem kötelező logikai érték. Azt jelzi, hogy meg szeretné-e jeleníteni a fájlt Megoldáskezelő a Visual Studióban. |
| CopyToOutputDirectory | Nem kötelező sztring. Meghatározza, hogy a fájlt a kimeneti könyvtárba szeretné-e másolni. Az értékek a következők: 1. Soha 2. Mindig 3. PreserveNewest 4. IfDifferent |
| Logikai név | Kötelező sztring. A beágyazott erőforrás logikai neve. |
Tartalom
Olyan fájlokat jelöl, amelyek nem a projektbe lesznek lefordítva, de beágyazhatók vagy közzétehetők vele együtt.
| Elem metaadatainak neve | Leírás |
|---|---|
| DependentUpon | Nem kötelező sztring. Azt a fájlt adja meg, amelytől a fájl a megfelelő fordítástól függ. |
| Generátor | Nem kötelező sztring. Az elemen futó fájlgenerátor neve. |
| LastGenOutput | Nem kötelező sztring. Az elemen futó bármely fájlgenerátor által létrehozott fájl neve. |
| CustomToolNamespace | Nem kötelező sztring. Az a névtér, amelyben az elemen futó bármely fájlgenerátornak létre kell hoznia a kódot. |
| Láncszem | Nem kötelező sztring. A megjelenítendő jelölési útvonal, ha a fájl fizikailag a projekt hatásán kívül található. |
| PublishState | Kötelező sztring. A tartalom közzétételi állapota: -Alapértelmezett -Tartalmazza -Kizárt -Datafile -Előfeltétel |
| IsAssembly | Nem kötelező logikai érték. Megadja, hogy a fájl szerelvény-e. |
| Látható | Nem kötelező logikai érték. Azt jelzi, hogy meg szeretné-e jeleníteni a fájlt Megoldáskezelő a Visual Studióban. |
| CopyToOutputDirectory | Nem kötelező sztring. Meghatározza, hogy a fájlt a kimeneti könyvtárba szeretné-e másolni. Az értékek a következők: 1. Soha 2. Mindig 3. PreserveNewest 4. IfDifferent |
| TargetPath | Nem kötelező sztring. Egy elem kimeneti elérési útja (a konfigurációhoz és/vagy platformspecifikus kimeneti könyvtárhoz viszonyítva), beleértve a fájlnevet is. Ez tiszteletben tartja a Link metaadatokat, ha meg van adva. Ha a TargetPath nincs megadva, az a buildelési folyamat során lesz kiszámítva. Lásd: AssignTargetPath. |
Egyik sem
Azokat a fájlokat jelöli, amelyeknek nem kell szerepkörüknek lennie a buildelési folyamatban.
| Elem metaadatainak neve | Leírás |
|---|---|
| DependentUpon | Nem kötelező sztring. Azt a fájlt adja meg, amelytől a fájl a megfelelő fordítástól függ. |
| Generátor | Nem kötelező sztring. Az elemen futó fájlgenerátor neve. |
| LastGenOutput | Nem kötelező sztring. Az elemen futtatott bármely fájlgenerátor által létrehozott fájl neve. |
| CustomToolNamespace | Nem kötelező sztring. Az a névtér, amelyben az elemen futó bármely fájlgenerátornak létre kell hoznia a kódot. |
| Láncszem | Nem kötelező sztring. A megjelenítendő jelölési útvonal, ha a fájl fizikailag a projekt hatásán kívül található. |
| Látható | Nem kötelező logikai érték. Azt jelzi, hogy meg szeretné-e jeleníteni a fájlt Megoldáskezelő a Visual Studióban. |
| CopyToOutputDirectory | Nem kötelező sztring. Meghatározza, hogy a fájlt a kimeneti könyvtárba szeretné-e másolni. Az értékek a következők: 1. Soha 2. Mindig 3. PreserveNewest 4. IfDifferent |
AssemblyMetadata
A [AssemblyMetadata(key, value)]ként létrehozandó szerelvényattribútumokat jelöli.
| Elem metaadatainak neve | Leírás |
|---|---|
| Tartalmaz | A AssemblyMetadataAttribute attribútumkonstruktor első paramétere (a kulcs). |
| Érték | Kötelező sztring. A második paraméter (az érték) lesz a AssemblyMetadataAttribute attribútumkonstruktorban. |
Jegyzet
Ez az elem a .NET 5 -höz (és .NET Core-hoz) készült SDK-t és újabb verziót használó projektekre vonatkozik.
InternalsVisibleTo
Megadja azokat a szerelvényeket, amelyeket [InternalsVisibleTo(..)] szerelvényattribútumként kell kibocsátani.
| Elem metaadatainak neve | Leírás |
|---|---|
| Tartalmaz | A szerelvény neve. |
| Kulcs | Nem kötelező sztring. A közgyűlés nyilvános kulcsa. |
Jegyzet
Ez az elem a .NET 5 -höz (és .NET Core-hoz) készült SDK-t és újabb verziót használó projektekre vonatkozik.
BaseApplicationManifest
A build alapalkalmazás-jegyzékfájlja, amely tartalmazza a ClickOnce üzembehelyezési biztonsági adatait.
CodeAnalysisImport
Az importálandó FxCop-projektet jelöli.
Importál
Olyan szerelvényeket jelöl, amelyeknek a névtereit a Visual Basic fordítónak kell importálnia.
Mappa
Ezt az elemet a Visual Studio csak üres mappa helyőrzőjeként használja. A mappa feltöltése után egy másik elem váltja fel.