Algemene MSBuild-projectitems
In MSBuild is een item een benoemde verwijzing naar een of meer bestanden. Items bevatten metagegevens zoals bestandsnamen, paden en versienummers. Alle projecttypen in Visual Studio hebben verschillende items gemeen. Deze items worden gedefinieerd in het bestand Microsoft.Build.CommonTypes.xsd.
In dit artikel vindt u een overzicht van alle algemene projectitems.
Reference
Vertegenwoordigt een assembly-verwijzing (beheerd) in het project.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| HintPath | Optionele tekenreeks. Relatief of absoluut pad van de assembly. |
| Naam | Optionele tekenreeks. De weergavenaam van de assembly, bijvoorbeeld 'System.Windows.Forms'. |
| FusionName | Optionele tekenreeks. Hiermee geeft u de eenvoudige of sterke fusienaam voor het item. Wanneer dit kenmerk aanwezig is, kan het tijd besparen omdat het assemblybestand niet hoeft te worden geopend om de naam van de fusie op te halen. |
| SpecificVersion | Optionele Booleaanse waarde. Hiermee geeft u op of alleen naar de versie in de fusionnaam moet worden verwezen. |
| Aliassen | Optionele tekenreeks. Alle aliassen voor de verwijzing. |
| Privé | Optionele Booleaanse waarde. Hiermee geeft u op of de verwijzing naar de uitvoermap moet worden gekopieerd. Dit kenmerk komt overeen met de eigenschap Lokale kopiëren van de verwijzing in de Visual Studio IDE. |
COMReference
Vertegenwoordigt een COM-componentverwijzing (onbeheerd) in het project. Dit item is alleen van toepassing op .NET-projecten.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| Naam | Optionele tekenreeks. De weergavenaam van het onderdeel. |
| Guid | Vereiste tekenreeks. Een GUID voor het onderdeel, in de vorm {12345678-1234-1234-1234-123456781234}. |
| VersionMajor | Vereiste tekenreeks. Het belangrijkste deel van het versienummer van het onderdeel. Bijvoorbeeld '5' als het volledige versienummer 5.46 is. |
| VersionMinor | Vereiste tekenreeks. Het secundaire deel van het versienummer van het onderdeel. Bijvoorbeeld '46' als het volledige versienummer 5.46 is. |
| EmbedInteropTypes | Optionele Booleaanse waarde. Indien waar, sluit u de interoperabiliteitstypen uit deze verwijzing rechtstreeks in uw assembly in in plaats van een interop-DLL te genereren. |
| Lcid | Optionele tekenreeks. De LocaleID voor het onderdeel. |
| WrapperTool | Optionele tekenreeks. De naam van het wrapper-hulpprogramma dat wordt gebruikt voor het onderdeel. Waarden zijn: 1. primair 2. tlbimp 3. primaryortlbimp 4. aximp |
| Geïsoleerd | Optionele Booleaanse waarde. Hiermee geeft u op of het onderdeel een reg-free component is. |
COMFileReference
Vertegenwoordigt een lijst met typebibliotheken die worden doorgegeven aan de parameter TypeLibFiles van de ResolveComReference doel. Dit item is alleen van toepassing op .NET-projecten.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| WrapperTool | Optionele tekenreeks. De naam van het wrapper-hulpprogramma dat wordt gebruikt voor het onderdeel. Waarden zijn: 1. primair 2. tlbimp 3. primaryortlbimp 4. aximp |
NativeReference
Vertegenwoordigt een systeemeigen manifestbestand of een verwijzing naar een dergelijk bestand.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| Naam | Vereiste tekenreeks. De basisnaam van het manifestbestand. |
| HintPath | Vereiste tekenreeks. Het relatieve pad van het manifestbestand. |
ProjectReference
Vertegenwoordigt een verwijzing naar een ander project.
ProjectReference items worden omgezet in Verwijzings- items door het ResolveProjectReferences doel, zodat alle geldige metagegevens op een verwijzing geldig kunnen zijn op ProjectReference, als het transformatieproces dit niet overschrijft.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| Naam | Optionele tekenreeks. De weergavenaam van de verwijzing. |
| GlobalPropertiesToRemove | Optionele string[]. Namen van eigenschappen die moeten worden verwijderd bij het bouwen van het project waarnaar wordt verwezen, bijvoorbeeld RuntimeIdentifier;PackOnBuild. De standaardwaarde is leeg. |
| Project | Optionele tekenreeks. Een GUID voor de verwijzing, in de vorm {12345678-1234-1234-1234-123456781234}. |
| OutputItemType | Optionele tekenreeks. Itemtype om doeluitvoer naar te verzenden. De standaardwaarde is leeg. Als de referentiemetagegevens zijn ingesteld op 'true' (standaard), worden doeluitvoer verwijzingen voor de compiler. |
| ReferenceOutputAssembly | Optionele Booleaanse waarde. Als dit is ingesteld op false, bevat dit niet de uitvoer van het project waarnaar wordt verwezen als een Reference van dit project, maar zorgt er nog steeds voor dat het andere project vóór dit project wordt gebouwd. Standaard ingesteld op true. |
| Privé | Optionele Booleaanse waarde. Hiermee geeft u op of de verwijzing naar de uitvoermap moet worden gekopieerd. Dit kenmerk komt overeen met de eigenschap Lokale kopiëren van de verwijzing in de Visual Studio IDE. |
| SetConfiguration | Optionele tekenreeks. Hiermee stelt u de globale eigenschap Configuration voor het project waarnaar wordt verwezen, bijvoorbeeld Configuration=Release. |
| SetPlatform | Optionele tekenreeks. Hiermee stelt u de globale eigenschap Platform voor het project waarnaar wordt verwezen, bijvoorbeeld Platform=AnyCPU. |
| SetTargetFramework | Optionele tekenreeks. Hiermee stelt u de globale eigenschap TargetFramework voor het project waarnaar wordt verwezen, bijvoorbeeld TargetFramework=netstandard2.0. |
| SkipGetTargetFrameworkProperties | Optionele Booleaanse waarde. Als true, bouwt u het project waarnaar wordt verwezen zonder de meest compatibele TargetFramework waarde te onderhandelen. Standaard ingesteld op false. |
| Doelstellingen | Optionele string[]. Door puntkomma's gescheiden lijst met doelen in de projecten waarnaar wordt verwezen, die moeten worden gebouwd. De standaardwaarde is de waarde van $(ProjectReferenceBuildTargets), die standaard leeg is, waarmee de standaarddoelen worden aangegeven. Wanneer u in Visual Studio bouwt (in plaats van MSBuild.exe of dotnet build), wordt hiermee niet voorkomen dat Visual Studio de standaarddoelen van het project waarnaar wordt verwezen, bouwt. |
Notitie
Er is een verschil tussen de werking van projectverwijzingen tussen .NET Framework en .NET Core (inclusief .NET 5 en hoger). In .NET Framework-projecten zijn projectverwijzingen niet transitief. Als Project1 verwijst naar Project2 en Project2 verwijst naar Project3, kunt u geen code uitvoeren voor Project3 vanuit Project1. In .NET Core (inclusief .NET 5 en hoger) worden projectverwijzingen echter transitief. U kunt code uitvoeren op Project3 in Project1.
Compileren
Vertegenwoordigt de bronbestanden voor de compiler.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| DependentUpon | Optionele tekenreeks. Hiermee geeft u het bestand dat dit bestand is afhankelijk van het correct compileren. |
| AutoGen | Optionele Booleaanse waarde. Geeft aan of het bestand is gegenereerd voor het project door de IDE (Integrated Development Environment) van Visual Studio. |
| Verbinden | Optionele tekenreeks. Het notatiepad dat moet worden weergegeven wanneer het bestand zich fysiek buiten de invloed van het projectbestand bevindt. |
| Zichtbaar | Optionele Booleaanse waarde. Hiermee wordt aangegeven of het bestand moet worden weergegeven in Solution Explorer- in Visual Studio. |
| CopyToOutputDirectory | Optionele tekenreeks. Bepaalt of het bestand naar de uitvoermap moet worden gekopieerd. Waarden zijn: 1. Nooit 2. Altijd 3. Nieuwste behouden 4. IfDifferent |
EmbeddedResource
Vertegenwoordigt resources die moeten worden ingesloten in de gegenereerde assembly.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| Cultuur | Optionele tekenreeks. Hiermee geeft u de cultuur van het resourcebestand. Indien opgegeven, wordt de cultuur niet automatisch afgeleid door het buildproces op basis van de bestandsextensie (die afhankelijk is van de culturen die beschikbaar zijn voor .NET/OS op de computer waarop de build wordt gehost). Het instellen van Culture={culture identifier} of WithCulture=false metagegevens wordt ten zeerste aanbevolen. |
| WithCulture | Optioneel bool. Hiermee geeft u op dat het bestand cultuurneutraal is en cultuurdetectie door AssignCulture taak moet worden overgeslagen. Het instellen van Culture={culture identifier} of WithCulture=false metagegevens wordt ten zeerste aanbevolen. |
| DependentUpon | Optionele tekenreeks. Hiermee geeft u het bestand dat dit bestand afhankelijk is van het correct compileren |
| Generator | Optionele tekenreeks. De naam van een bestandsgenerator die op dit item wordt uitgevoerd. |
| LastGenOutput | Optionele tekenreeks. De naam van het bestand dat is gemaakt door een bestandsgenerator die op dit item is uitgevoerd. |
| CustomToolNamespace | Optionele tekenreeks. De naamruimte waarin een bestandsgenerator die op dit item wordt uitgevoerd, code moet maken. |
| Verbinden | Optionele tekenreeks. Het notatiepad wordt weergegeven als het bestand zich fysiek buiten de invloed van het project bevindt. |
| Zichtbaar | Optionele Booleaanse waarde. Hiermee wordt aangegeven of het bestand moet worden weergegeven in Solution Explorer- in Visual Studio. |
| CopyToOutputDirectory | Optionele tekenreeks. Bepaalt of het bestand naar de uitvoermap moet worden gekopieerd. Waarden zijn: 1. Nooit 2. Altijd 3. Nieuwste behouden 4. IfDifferent |
| LogicalName | Vereiste tekenreeks. De logische naam van de ingesloten resource. |
Tevreden
Vertegenwoordigt bestanden die niet in het project zijn gecompileerd, maar die samen met het project kunnen worden ingesloten of gepubliceerd.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| DependentUpon | Optionele tekenreeks. Hiermee geeft u het bestand dat dit bestand is afhankelijk van het correct compileren. |
| Generator | Optionele tekenreeks. De naam van een bestandsgenerator die op dit item wordt uitgevoerd. |
| LastGenOutput | Optionele tekenreeks. De naam van het bestand dat is gemaakt door een bestandsgenerator die op dit item is uitgevoerd. |
| CustomToolNamespace | Optionele tekenreeks. De naamruimte waarin een bestandsgenerator die op dit item wordt uitgevoerd, code moet maken. |
| Verbinden | Optionele tekenreeks. Het notatiepad dat moet worden weergegeven als het bestand zich fysiek buiten de invloed van het project bevindt. |
| PublishState | Vereiste tekenreeks. De publicatiestatus van de inhoud: -Verstek -Inbegrepen -Uitgesloten -Datafile -Voorwaarde |
| IsAssembly | Optionele Booleaanse waarde. Hiermee geeft u op of het bestand een assembly is. |
| Zichtbaar | Optionele Booleaanse waarde. Hiermee wordt aangegeven of het bestand moet worden weergegeven in Solution Explorer- in Visual Studio. |
| CopyToOutputDirectory | Optionele tekenreeks. Bepaalt of het bestand naar de uitvoermap moet worden gekopieerd. Waarden zijn: 1. Nooit 2. Altijd 3. Nieuwste behouden 4. IfDifferent |
| TargetPath | Optionele tekenreeks. Het uitvoerpad (ten opzichte van de configuratie- en/of platformspecifieke uitvoermap) van een item, inclusief de bestandsnaam. Dit respecteert de Link metagegevens, indien opgegeven. Als TargetPath niet is opgegeven, wordt dit berekend tijdens het buildproces. Zie AssignTargetPath-. |
Geen
Vertegenwoordigt bestanden die geen rol moeten hebben in het buildproces.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| DependentUpon | Optionele tekenreeks. Hiermee geeft u het bestand dat dit bestand is afhankelijk van het correct compileren. |
| Generator | Optionele tekenreeks. De naam van een bestandsgenerator die op dit item wordt uitgevoerd. |
| LastGenOutput | Optionele tekenreeks. De naam van het bestand dat is gemaakt door een bestandsgenerator die op dit item is uitgevoerd. |
| CustomToolNamespace | Optionele tekenreeks. De naamruimte waarin een bestandsgenerator die op dit item wordt uitgevoerd, code moet maken. |
| Verbinden | Optionele tekenreeks. Het notatiepad dat moet worden weergegeven als het bestand zich fysiek buiten de invloed van het project bevindt. |
| Zichtbaar | Optionele Booleaanse waarde. Hiermee wordt aangegeven of het bestand moet worden weergegeven in Solution Explorer- in Visual Studio. |
| CopyToOutputDirectory | Optionele tekenreeks. Bepaalt of het bestand naar de uitvoermap moet worden gekopieerd. Waarden zijn: 1. Nooit 2. Altijd 3. Nieuwste behouden 4. IfDifferent |
AssemblyMetadata
Vertegenwoordigt assemblykenmerken die moeten worden gegenereerd als [AssemblyMetadata(key, value)].
| Naam van metagegevens van item | Beschrijving |
|---|---|
| Bevatten | Wordt de eerste parameter (de sleutel) in de AssemblyMetadataAttribute kenmerkconstructor. |
| Waarde | Vereiste tekenreeks. Wordt de tweede parameter (de waarde) in de AssemblyMetadataAttribute kenmerkconstructor. |
Notitie
Dit item is van toepassing op projecten die gebruikmaken van de SDK voor .NET 5 (en .NET Core) en latere versies.
InternalsVisibleTo
Hiermee geeft u assembly's die moeten worden verzonden als [InternalsVisibleTo(..)] assemblykenmerken.
| Naam van metagegevens van item | Beschrijving |
|---|---|
| Bevatten | De assemblynaam. |
| Sleutel | Optionele tekenreeks. De openbare sleutel van de assembly. |
Notitie
Dit item is van toepassing op projecten die gebruikmaken van de SDK voor .NET 5 (en .NET Core) en latere versies.
BaseApplicationManifest
Vertegenwoordigt het basistoepassingsmanifest voor de build en bevat beveiligingsgegevens voor ClickOnce-implementatie.
CodeAnalysisImport
Vertegenwoordigt het FxCop-project dat moet worden geïmporteerd.
Importeren
Vertegenwoordigt assembly's waarvan de naamruimten moeten worden geïmporteerd door de Visual Basic-compiler.
Map
Dit element wordt alleen door Visual Studio gebruikt als tijdelijke aanduiding voor een lege map. Wanneer de map is ingevuld, wordt deze vervangen door een ander element.