Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In MSBuild ist ein Element ein benannter Verweis auf eine oder mehrere Zeichenfolgen, z. B. Dateinamen. Elemente enthalten Metadaten wie Dateinamen, Pfade und Versionsnummern. Alle Projekttypen in Visual Studio weisen mehrere gemeinsame Elemente auf. Diese Elemente werden in der Datei "Microsoft.Build.CommonTypes.xsd" definiert.
In diesem Artikel werden alle allgemeinen Projektelemente aufgeführt, die in MSBuild selbst definiert sind. Elemente und Eigenschaften, die vom .NET SDK bereitgestellt werden, werden in der MSBuild-Referenz für Microsoft.Net.Sdk dokumentiert.
MSBuild selbst legt keinen Wert für optionale Metadaten fest, und nicht festgelegte Metadaten entsprechen einer leeren Zeichenfolge. Daher ist der Standardwert für optionale Metadaten die leere Zeichenfolge. Metadatenwerte werden jedoch manchmal in SDK-Dateien festgelegt, die implizit importiert werden. Die Werte hängen davon ab, auf das SDK verwiesen wird.
Reference
Stellt einen .NET-Assemblyverweis (verwaltet) im Projekt dar.
| Elementmetadatenname | Description |
|---|---|
| HintPath | Optionale Zeichenfolge. Relativer oder absoluter Pfad der Assembly. |
| Name | Optionale Zeichenfolge. Der Anzeigename der Assembly, z. B. "System.Windows.Forms". |
| FusionName | Optionale Zeichenfolge. Gibt den einfachen oder starken Fusionsnamen für das Element an. Wenn dieses Attribut vorhanden ist, kann es Zeit sparen, da die Assemblydatei nicht geöffnet werden muss, um den Fusionsnamen abzurufen. |
| SpecificVersion | Optionaler boolescher Wert. Gibt an, ob nur auf die Version im Fusionsnamen verwiesen werden soll. |
| Aliases | Optionale Zeichenfolge. Alle Aliase für den Verweis. |
| Private | Optionaler boolescher Wert. Gibt an, ob der Verweis in den Ausgabeordner kopiert werden soll. Dieses Attribut entspricht der Copy Local-Eigenschaft des Verweises, der sich in der Visual Studio-IDE befindet. Standardmäßig wird false. |
Note
Der Reference Elementtyp kann auch verwendet werden, um auf vorgenerierte Wrapperassemblys für systemeigene COM-Objekte zu verweisen, z. B. wenn Sie eine PIA (primäre Interopassembly) generiert haben tlbimp.exe . Dieser Verweistyp ist eine geeignete Wahl, wenn Sie die COM-Wrapperassemblys selbst mit bekannten Eingaben generieren möchten, anstatt sich auf den Algorithmus von MSBuild zu verlassen, um COM-Wrapper zur Buildzeit zu generieren, wodurch eine Abhängigkeit vom Status der Systemregistrierung auf dem Buildcomputer eingeführt wird, auf dem MSBuild ausgeführt wird.
COMReference
Stellt einen COM-Komponentenverweis (nicht verwaltet) im Projekt dar. Dieses Element wird von der ResolveComReference-Aufgabe verwendet, die die Wrapperassemblys generiert oder bei EmbedInteropTypes Verwendung die Interoptypen in Die Assembly einbettet. Die Verwendung dieses Referenztyps führt zu einer Abhängigkeit von der Systemregistrierung auf dem Buildcomputer, die zum Nachschlagen des referenzierten COM-Objekts verwendet wird. COM-Artefakte und COM-Einträge in der Registrierung können sich ändern, wenn Produkte auf dem Computer installiert, aktualisiert oder deinstalliert werden (oder wenn Sie denselben Build auf einem anderen Computer ausführen), möglicherweise eine andere Wrapperassembly erzeugen, auch wenn sich die Buildlogik nicht geändert hat.
Dieses Element gilt nicht für non-.NET Projekte.
| Elementmetadatenname | Description |
|---|---|
| Name | Optionale Zeichenfolge. Der Anzeigename der Komponente. |
| Guid | Erforderliche Zeichenfolge. Eine GUID für die Komponente im Formular {12345678-1234-1234-1234-123456781234}. |
| VersionMajor | Erforderliche Zeichenfolge. Der Hauptteil der Versionsnummer der Komponente. Beispiel: "5", wenn die Vollversionsnummer "5.46" lautet. |
| VersionMinor | Erforderliche Zeichenfolge. Der Nebenteil der Versionsnummer der Komponente. Beispiel: "46", wenn die Vollversionsnummer "5.46" lautet. |
| EmbedInteropTypes | Optionaler boolescher Wert. Wenn true, betten Sie die Interoperabilitätstypen aus diesem Verweis direkt in Ihre Assembly ein, anstatt eine Interop-DLL zu generieren. |
| Lcid | Optionale Zeichenfolge. Die LocaleID für die Komponente. |
| WrapperTool | Optionale Zeichenfolge. Der Name des Wrappertools, das für die Komponente verwendet wird. Die Werte sind: 1. primär 2. tlbimp 3. primaryortlbimp 4. aximp |
| Isolated | Optionaler boolescher Wert. Gibt an, ob es sich bei der Komponente um eine reg-freie Komponente handelt. Standardmäßig wird false. |
Weitere Informationen finden Sie unter "Problembehandlung bei COM-Verweisen".
COMFileReference
Stellt eine Liste der Typbibliotheken dar, auf die anhand des Dateipfads verwiesen werden soll, anstatt die Systemregistrierung zu verwenden. Dieser Verweistyp kann eine gute Alternative zu COMReference sein, wenn Sie eine Abhängigkeit von der Registrierung des Buildcomputers vermeiden möchten, entweder weil das Konto, das den Build ausführt, keine erhöhten Berechtigungen zum Bearbeiten der Registrierung auf dem Buildserver hat oder Sie nicht möchten, dass der Build eine Abhängigkeit vom Status der Registrierung hat. Wenn Sie COMFileReference auf ein Artefakt auf einem Systempfad verweisen, hat Ihr Build eine Abhängigkeit vom Systemstatus. Wenn sich das Systemartefakt aufgrund einer Änderung des Zustands des Systems ändert, z. B. wenn Produkte installiert, aktualisiert oder deinstalliert werden (oder wenn Sie denselben Build auf einem anderen Computer ausführen), kann sich die Wrapperassembly ändern, auch wenn sich die Buildlogik nicht geändert hat. Um ein konsistentes Buildergebnis sicherzustellen, können Sie eine bekannte Kopie des COM-Artefaktes an einem Ort zwischenspeichern, den Sie steuern, z. B. unter Ihrem Projekt- oder Lösungsordner, und verweisen Sie darauf anstelle des Systemartefaktes.
Dieses Element gilt nicht für non-.NET Projekte.
| Elementmetadatenname | Description |
|---|---|
| EmbedInteropTypes | Optionaler boolescher Wert. Wenn true, betten Sie die Interoperabilitätstypen aus diesem Verweis direkt in Ihre Assembly ein, anstatt eine Interop-DLL zu generieren. Der Standardwert ist "false". |
| WrapperTool | Optionale Zeichenfolge. Der Name des Wrappertools, das für die Komponente verwendet wird. Die Werte sind: 1. primär 2. tlbimp 3. primaryortlbimp 4. aximp |
Weitere Informationen finden Sie unter "Problembehandlung bei COM-Verweisen".
NativeReference
Stellt eine systemeigene Manifestdatei oder einen Verweis auf eine solche Datei dar.
| Elementmetadatenname | Description |
|---|---|
| Name | Erforderliche Zeichenfolge. Der Basisname der Manifestdatei. |
| HintPath | Erforderliche Zeichenfolge. Der relative Pfad der Manifestdatei. |
ProjectReference
Stellt einen Verweis auf ein anderes Projekt dar.
ProjectReference Elemente werden durch das Ziel in ResolveProjectReferences Elemente umgewandelt, sodass alle gültigen Metadaten für einen Verweis auf ProjectReferencegültig sein können, wenn der Transformationsprozess sie nicht überschreibt.
| Elementmetadatenname | Description |
|---|---|
| Name | Optionale Zeichenfolge. Der Anzeigename des Verweises. |
| GlobalPropertiesToRemove | Optionaler string[]. Namen von Eigenschaften, die beim Erstellen des referenzierten Projekts entfernt werden sollen, z. B. RuntimeIdentifier;PackOnBuild. Der Standardwert ist leer. |
| Project | Optionale Zeichenfolge. Eine GUID für den Verweis im Formular {12345678-1234-1234-1234-123456781234}. |
| OutputItemType | Optionale Zeichenfolge. Elementtyp, in den Zielausgaben ausgegeben werden sollen. Der Standardwert ist leer. Wenn die Referenzmetadaten auf "true" (Standardeinstellung) festgelegt sind, werden die Zielausgaben zu Verweisen für den Compiler. |
| ReferenceOutputAssembly | Optionaler boolescher Wert. Bei Festlegung auf false, schließt die Ausgabe des referenzierten Projekts nicht als Referenz dieses Projekts ein, stellt aber dennoch sicher, dass das andere Projekt vor diesem Projekt erstellt wird. Standardmäßig wird true. |
| BuildReference | Optionaler boolescher Wert. Standardmäßig wird true. Wenn dieser Wert auf false"ProjectReference" festgelegt ist, wird von MSBuild nicht erstellt. Die Standardziele (siehe unten "Ziele") werden überhaupt nicht aufgerufen. |
| Private | Optionaler boolescher Wert. Gibt an, ob der Verweis in den Ausgabeordner kopiert werden soll. Dieses Attribut entspricht der Copy Local-Eigenschaft des Verweises, der sich in der Visual Studio-IDE befindet. |
| SetConfiguration | Optionale Zeichenfolge. Legt die globale Eigenschaft Configuration für das referenzierte Projekt fest, z. B. Configuration=Release. |
| SetPlatform | Optionale Zeichenfolge. Legt die globale Eigenschaft Platform für das referenzierte Projekt fest, z. B. Platform=AnyCPU. |
| SetTargetFramework | Optionale Zeichenfolge. Legt die globale Eigenschaft TargetFramework für das referenzierte Projekt fest, z. B. TargetFramework=netstandard2.0. |
| SkipGetTargetFrameworkProperties | Optionaler boolescher Wert. Wenn true, wird das referenzierte Projekt erstellt, ohne den am besten kompatiblen TargetFramework Wert zu verhandeln. Standardmäßig wird false. |
| Targets | Optionaler string[]. Durch Semikolons getrennte Liste der Ziele in den referenzierten Projekten, die erstellt werden sollen. Der Standardwert ist der Wert von $(ProjectReferenceBuildTargets), der standardmäßig leer ist und die Standardziele angibt. Wenn Sie in Visual Studio (im Gegensatz zu MSBuild.exe oder dotnet build) erstellen, wird dadurch nicht verhindert, dass Visual Studio die Standardziele des referenzierten Projekts erstellt. |
Note
Es gibt einen Unterschied zwischen der Funktionsweise von Projektverweise zwischen .NET Framework und .NET Core (einschließlich .NET 5 und höher). In .NET Framework-Projekten sind Projektverweise nicht transitiv. Wenn Project1 auf Project2 verweist und Project2 auf Project3 verweist, können Sie project3 nicht mit Project3 aus Project1 codieren. In .NET Core (einschließlich .NET 5 und höher) sind Projektverweise jedoch transitiv. Sie können code für Project3 in Project1.
Compile
Stellt die Quelldateien für den Compiler dar.
| Elementmetadatenname | Description |
|---|---|
| DependentUpon | Optionale Zeichenfolge. Gibt die Datei an, von der diese Datei abhängig ist, um ordnungsgemäß zu kompilieren. |
| AutoGen | Optionaler boolescher Wert. Gibt an, ob die Datei für das Projekt von der integrierten Entwicklungsumgebung (IDE) von Visual Studio generiert wurde. Standardmäßig wird false. |
| Link | Optionale Zeichenfolge. Der notationale Pfad, der angezeigt werden soll, wenn sich die Datei physisch außerhalb des Einflusses der Projektdatei befindet. |
| Visible | Optionaler boolescher Wert. Gibt an, ob die Datei im Projektmappen-Explorer in Visual Studio angezeigt werden soll. Standardmäßig wird true. |
| CopyToOutputDirectory | Optionale Zeichenfolge. Bestimmt, ob die Datei in das Ausgabeverzeichnis kopiert werden soll. Die Werte sind: 1. Nie 2. Immer 3. PreserveNewest 4. IfDifferent Never
DefineExplicitDefaults Ist standardmäßig auf true; andernfalls wird standardmäßig die leere Zeichenfolge festgelegt. |
EmbeddedResource
Stellt Ressourcen dar, die in die generierte Assembly eingebettet werden sollen.
| Elementmetadatenname | Description |
|---|---|
| Culture | Optionale Zeichenfolge. Gibt die Kultur der Ressourcendatei an. Wenn angegeben, leitet der Buildprozess die Kultur nicht automatisch basierend auf der Dateierweiterung ab (die von den Kulturen abhängig ist, die für .NET/OS auf dem Computer verfügbar sind, auf dem der Build gehostet wird). Das Festlegen Culture={culture identifier} oder WithCulture=false Metadaten wird dringend empfohlen. |
| WithCulture | Optionaler Bool. Gibt an, dass die Datei kulturneutral ist und die Erkennung von Kultur durch AssignCulture Aufgabe übersprungen werden soll. Das Festlegen Culture={culture identifier} oder WithCulture=false Metadaten wird dringend empfohlen. |
| DependentUpon | Optionale Zeichenfolge. Gibt die Datei an, von der diese Datei abhängig ist, um ordnungsgemäß zu kompilieren. |
| Generator | Optionale Zeichenfolge. Der Name eines beliebigen Dateigenerators, der für dieses Element ausgeführt wird. |
| LastGenOutput | Optionale Zeichenfolge. Der Name der Datei, die von jedem Dateigenerator erstellt wurde, der für dieses Element ausgeführt wurde. |
| CustomToolNamespace | Optionale Zeichenfolge. Der Namespace, in dem jeder Dateigenerator, der für dieses Element ausgeführt wird, Code erstellen soll. |
| Link | Optionale Zeichenfolge. Der Notationalpfad wird angezeigt, wenn sich die Datei physisch außerhalb des Einflusses des Projekts befindet. |
| Visible | Optionaler boolescher Wert. Gibt an, ob die Datei im Projektmappen-Explorer in Visual Studio angezeigt werden soll. |
| CopyToOutputDirectory | Optionale Zeichenfolge. Bestimmt, ob die Datei in das Ausgabeverzeichnis kopiert werden soll. Die Werte sind: 1. Nie 2. Immer 3. PreserveNewest 4. IfDifferent Never
DefineExplicitDefaults Ist standardmäßig auf true; andernfalls wird standardmäßig die leere Zeichenfolge festgelegt. |
| LogicalName | Erforderliche Zeichenfolge. Der logische Name der eingebetteten Ressource. |
Content
Stellt Dateien dar, die nicht in das Projekt kompiliert werden, aber möglicherweise zusammen eingebettet oder veröffentlicht werden.
| Elementmetadatenname | Description |
|---|---|
| DependentUpon | Optionale Zeichenfolge. Gibt die Datei an, von der diese Datei abhängig ist, um ordnungsgemäß zu kompilieren. |
| Generator | Optionale Zeichenfolge. Der Name eines beliebigen Dateigenerators, der für dieses Element ausgeführt wird. |
| LastGenOutput | Optionale Zeichenfolge. Der Name der Datei, die von einem Beliebigen Dateigenerator erstellt wurde, der für dieses Element ausgeführt wurde. |
| CustomToolNamespace | Optionale Zeichenfolge. Der Namespace, in dem jeder Dateigenerator, der für dieses Element ausgeführt wird, Code erstellen soll. |
| Link | Optionale Zeichenfolge. Der notationale Pfad, der angezeigt werden soll, wenn sich die Datei physisch außerhalb des Einflusses des Projekts befindet. |
| PublishState | Erforderliche Zeichenfolge. Der Veröffentlichungsstatus des Inhalts: - Standard -Iinklusive -Ausgeschlossen -Datenfile -Voraussetzung |
| IsAssembly | Optionaler boolescher Wert. Gibt an, ob es sich bei der Datei um eine Assembly handelt. |
| Visible | Optionaler boolescher Wert. Gibt an, ob die Datei im Projektmappen-Explorer in Visual Studio angezeigt werden soll. |
| CopyToOutputDirectory | Optionale Zeichenfolge. Bestimmt, ob die Datei in das Ausgabeverzeichnis kopiert werden soll. Die Werte sind: 1. Nie 2. Immer 3. PreserveNewest 4. IfDifferent Never
DefineExplicitDefaults Ist standardmäßig auf true; andernfalls wird standardmäßig die leere Zeichenfolge festgelegt. |
| TargetPath | Optionale Zeichenfolge. Der Ausgabepfad (relativ zum konfigurations- und/oder plattformspezifischen Ausgabeverzeichnis) eines Elements, einschließlich des Dateinamens. Dies berücksichtigt die Link Metadaten, sofern angegeben. Wenn TargetPath nicht bereitgestellt wird, wird er während des Buildvorgangs berechnet. Siehe AssignTargetPath. |
None
Stellt Dateien dar, die keine Rolle im Buildprozess haben sollten.
| Elementmetadatenname | Description |
|---|---|
| DependentUpon | Optionale Zeichenfolge. Gibt die Datei an, von der diese Datei abhängig ist, um ordnungsgemäß zu kompilieren. |
| Generator | Optionale Zeichenfolge. Der Name eines beliebigen Dateigenerators, der für dieses Element ausgeführt wird. |
| LastGenOutput | Optionale Zeichenfolge. Der Name der Datei, die von jedem Dateigenerator erstellt wurde, der für dieses Element ausgeführt wurde. |
| CustomToolNamespace | Optionale Zeichenfolge. Der Namespace, in dem jeder Dateigenerator, der für dieses Element ausgeführt wird, Code erstellen soll. |
| Link | Optionale Zeichenfolge. Der notationale Pfad, der angezeigt werden soll, wenn sich die Datei physisch außerhalb des Einflusses des Projekts befindet. |
| Visible | Optionaler boolescher Wert. Gibt an, ob die Datei im Projektmappen-Explorer in Visual Studio angezeigt werden soll. |
| CopyToOutputDirectory | Optionale Zeichenfolge. Bestimmt, ob die Datei in das Ausgabeverzeichnis kopiert werden soll. Die Werte sind: 1. Nie 2. Immer 3. PreserveNewest 4. IfDifferent Never
DefineExplicitDefaults Ist standardmäßig auf true; andernfalls wird standardmäßig die leere Zeichenfolge festgelegt. |
AssemblyMetadata
Stellt Assemblyattribute dar, die als [AssemblyMetadata(key, value)]generiert werden sollen.
| Elementmetadatenname | Description |
|---|---|
| Include | Wird der erste Parameter (der Schlüssel) im AssemblyMetadataAttribute Attributkonstruktor. |
| Value | Erforderliche Zeichenfolge. Wird der zweite Parameter (der Wert) im AssemblyMetadataAttribute Attributkonstruktor. |
Note
Dieses Element gilt für Projekte, die das SDK für .NET 5 (und .NET Core) und höhere Versionen verwenden.
InternalsVisibleTo
Gibt Assemblys an, die als [InternalsVisibleTo(..)] Assemblyattribute ausgegeben werden sollen.
| Elementmetadatenname | Description |
|---|---|
| Include | Der Assemblyname. |
| Key | Optionale Zeichenfolge. Der öffentliche Schlüssel der Assembly. |
Note
Dieses Element gilt für Projekte, die das SDK für .NET 5 (und .NET Core) und höhere Versionen verwenden.
BaseApplicationManifest
Stellt das Basisanwendungsmanifest für den Build dar und enthält Sicherheitsinformationen zur ClickOnce-Bereitstellung.
CodeAnalysisImport
Stellt das zu importierende FxCop-Projekt dar.
Import
Stellt Assemblys dar, deren Namespaces vom Visual Basic-Compiler importiert werden sollen.
Folder
Dieses Element wird nur von Visual Studio als Platzhalter für einen leeren Ordner verwendet. Wenn der Ordner aufgefüllt wird, wird er durch ein anderes Element ersetzt.