MSBuild-Referenz für .NET SDK-Projekte

Diese Seite ist ein Verweis auf die MSBuild-Eigenschaften und -Elemente, mit denen Sie .NET Projekte konfigurieren können.

Note

Diese Seite ist in Bearbeitung und listet nicht alle nützlichen MSBuild-Eigenschaften für das .NET SDK auf. Eine Liste der gängigen MSBuild-Eigenschaften finden Sie unter Gemeinsame MSBuild-Projekteigenschaften.

Eigenschaften der Assemblyüberprüfung

Diese Eigenschaften und Elemente werden an die -Aufgabe übergeben. Weitere Informationen zur Assemblyüberprüfung finden Sie unter Assemblyüberprüfung.

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

ApiCompatStrictMode
ApiCompatValidateAssemblies

Note

Diese Eigenschaften sind noch nicht Teil des .NET SDK (noch). Um sie zu verwenden, müssen Sie auch zu Microsoft.DotNet.ApiCompat.Task hinzufügen.

Darüber hinaus gelten die folgenden Eigenschaften, die unter Eigenschaften der Paketüberprüfung dokumentiert sind, auch für die Assemblyüberprüfung:

ApiCompatEnableRuleAttributesMustMatch
ApiCompatEnableRuleCannotChangeParameterName
ApiCompatExcludeAttributesFile
ApiCompatGenerateSuppressionFile
ApiCompatPermitUnnecessarySuppressions
ApiCompatPreserveUnnecessarySuppressions
ApiCompatRespectInternals
ApiCompatSuppressionFile
ApiCompatSuppressionOutputFile
NoWarn
RoslynAssembliesPath

ApiCompatStrictMode

Bei Festlegung auf gibt die Eigenschaft an, dass API-Kompatibilitätsprüfungen im Strict-Modus ausgeführt werden sollen.

<PropertyGroup>
  <ApiCompatStrictMode>true</ApiCompatStrictMode>
</PropertyGroup>

ApiCompatValidateAssemblies

Die Eigenschaft aktiviert eine Reihe von Überprüfungen für die angegebenen Assemblys. Weitere Informationen dazu finden Sie unter Assemblyüberprüfung.

<PropertyGroup>
  <ApiCompatValidateAssemblies>true</ApiCompatValidateAssemblies>
</PropertyGroup>

Eigenschaften von Assemblyattributen

GenerateAssemblyInfo
GeneratedAssemblyInfoFile
IncludeSourceRevisionInInformationalVersion
SourceRevisionId

GenerateAssemblyInfo

Die -Eigenschaft steuert die Generierung des -Attributs für das Projekt. Standardwert: . Verwenden Sie , um die Generierung der Datei zu deaktivieren:

<PropertyGroup>
  <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
</PropertyGroup>

Die Einstellung GeneratedAssemblyInfoFile steuert den Namen der generierten Datei.

Wenn der -Wert lautet, werden paketbezogene Projekteigenschaften in Assemblyattribute umgewandelt.

Weitere Informationen zum Generieren von Assemblyattributen mithilfe einer Projektdatei finden Sie unter Festlegen von Assemblyattributen in einer Projektdatei.

GeneratedAssemblyInfoFile

Die -Eigenschaft definiert den relativen oder absoluten Pfad der generierten Assemblyinformationsdatei. Standardmäßig handelt es sich dabei um eine Datei mit dem Namensformat [projektname].AssemblyInfo.[cs|vb] im Verzeichnis (üblicherweise obj).

<PropertyGroup>
  <GeneratedAssemblyInfoFile>assemblyinfo.cs</GeneratedAssemblyInfoFile>
</PropertyGroup>

IncludeSourceRevisionInInformationalVersion

Die Eigenschaft steuert, ob der Wert an das Assembly-Attribut angefügt wird. Standardwert: . Legen Sie diese Einstellung fest, um dieses Verhalten zu deaktivieren:

<PropertyGroup>
  <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
</PropertyGroup>

Weitere Informationen finden Sie unter Source Link im .NET SDK.

SourceRevisionId

Die Eigenschaft enthält die Revisions-ID der Quellcodeverwaltung für den Build, z. B. einen Git-Commit-Hash. Ab .NET 8 füllt das .NET SDK diese Eigenschaft automatisch mit dem Commit-Hash auf, wenn Source Link vorhanden ist. Bei Festlegung wird der Wert an das Assembly-Attribut angefügt.

<PropertyGroup>
  <SourceRevisionId>abc1234</SourceRevisionId>
</PropertyGroup>

Weitere Informationen finden Sie unter Source Link im .NET SDK.

Framework-Eigenschaften

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

TargetFramework
TargetFrameworks
NetStandardImplicitPackageVersion

TargetFramework

Die Eigenschaft gibt die Zielframeworkversion für die App an. Eine Liste gültiger Zielframeworkmoniker finden Sie unter Zielframeworks in Projekten im SDK-Format.

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
</PropertyGroup>

Weitere Informationen finden Sie unter Zielframeworks in Projekten im SDK-Format.

TargetFrameworks

Verwenden Sie die Eigenschaft , wenn Sie Ihre App für mehrere Zielplattformen entwickeln möchten. Eine Liste gültiger Zielframeworkmoniker finden Sie unter Zielframeworks in Projekten im SDK-Format.

Note

Wenn (Plural) angegeben wird, wird (Singular) ignoriert.

<PropertyGroup>
  <TargetFrameworks>net8.0;net462</TargetFrameworks>
</PropertyGroup>

Weitere Informationen finden Sie unter Zielframeworks in Projekten im SDK-Format.

NetStandardImplicitPackageVersion

Note

Diese Eigenschaft gilt nur für Projekte, die verwenden. Sie gilt nicht für Projekte, die verwenden.

Verwenden Sie die Eigenschaft , wenn Sie eine Frameworkversion angeben möchten, die niedriger ist als die Metapaketversion. Die Projektdatei im folgenden Beispiel gilt für , verwendet aber Version 1.6.0 von .

<PropertyGroup>
  <TargetFramework>netstandard1.3</TargetFramework>
  <NetStandardImplicitPackageVersion>1.6.0</NetStandardImplicitPackageVersion>
</PropertyGroup>

Paketeigenschaften

Beschreibende Eigenschaften
PackRelease

Beschreibende Eigenschaften

Sie können Eigenschaften wie , , , und angeben, um das Paket zu beschreiben, das aus Ihrem Projekt erstellt wird. Informationen zu diesen und anderen Eigenschaften finden Sie unter Paketziel.

<PropertyGroup>
  ...
  <PackageId>ClassLibDotNetStandard</PackageId>
  <Version>1.0.0</Version>
  <Authors>John Doe</Authors>
  <Company>Contoso</Company>
</PropertyGroup>

PackRelease

Die -Eigenschaft ähnelt der PublishRelease-Eigenschaft, mit der Ausnahme, dass sie das Standardverhalten von ändert. Diese Eigenschaft wurde in .NET 7 eingeführt.

<PropertyGroup>
  <PackRelease>true</PackRelease>
</PropertyGroup>

Note

Ab dem .NET 8 SDK wird standardmäßig PackRelease standardmäßig auf true festgelegt. Weitere Informationen finden Sie unter „dotnet pack“ verwendet die Releasekonfiguration.

Paketüberprüfungseigenschaften

Diese Eigenschaften und Elemente werden an die -Aufgabe übergeben. Weitere Informationen zur Paketüberprüfung finden Sie in der Übersicht über die Paketüberprüfung.

Eigenschaften für die -Aufgabe finden Sie unter Eigenschaften der Assemblyüberprüfung.

Die folgenden MSBuild-Eigenschaften und -Elemente sind in diesem Abschnitt dokumentiert:

ApiCompatEnableRuleAttributesMustMatch
ApiCompatEnableRuleCannotChangeParameterName
ApiCompatExcludeAttributesFile
ApiCompatGenerateSuppressionFile
ApiCompatPermitUnnecessarySuppressions
ApiCompatPreserveUnnecessarySuppressions
ApiCompatRespectInternals
ApiCompatSuppressionFile
ApiCompatSuppressionOutputFile
EnablePackageValidation
EnableStrictModeForBaselineValidation
EnableStrictModeForCompatibleFrameworksInPackage
EnableStrictModeForCompatibleTfms
NoWarn
PackageValidationBaselineFrameworkToIgnore
PackageValidationBaselineName
PackageValidationBaselineVersion
PackageValidationReferencePath
RoslynAssembliesPath

ApiCompatEnableRuleAttributesMustMatch

Bei Festlegung auf aktiviert die Eigenschaft die Überprüfungsregel, die überprüft, ob Attribute übereinstimmen. Der Standardwert ist .

<PropertyGroup>
  <ApiCompatEnableRuleAttributesMustMatch>true</ApiCompatEnableRuleAttributesMustMatch>
</PropertyGroup>

ApiCompatEnableRuleCannotChangeParameterName

Bei Festlegung auf aktiviert die Eigenschaft die Überprüfungsregel, die überprüft, ob Parameternamen in öffentlichen Methoden geändert wurden. Der Standardwert ist .

<PropertyGroup>
  <ApiCompatEnableRuleCannotChangeParameterName>true</ApiCompatEnableRuleCannotChangeParameterName>
</PropertyGroup>

ApiCompatExcludeAttributesFile

Das -Element gibt den Pfad zu einer Datei an, die auszuschließende Attribute im Format DocId enthält.

<ItemGroup>
  <ApiCompatExcludeAttributesFile Include="ApiCompatExcludedAttributes.txt" />
  <ApiCompatExcludeAttributesFile Include="ApiCompatBaselineExcludedAttributes.txt" />
</ItemGroup>

ApiCompatGenerateSuppressionFile

Die -Eigenschaft gibt an, ob eine Kompatibilitätsunterdrückungsdatei generiert werden soll.

<PropertyGroup>
  <ApiCompatGenerateSuppressionFile>true</ApiCompatGenerateSuppressionFile>
</PropertyGroup>

ApiCompatPermitUnnecessarySuppressions

Die -Eigenschaft gibt an, ob unnötige Unterdrückungen in der Unterdrückungsdatei zulässig sind.

Der Standardwert ist .

<PropertyGroup>
  <ApiCompatPermitUnnecessarySuppressions>true</ApiCompatPermitUnnecessarySuppressions>
</PropertyGroup>

ApiCompatPreserveUnnecessarySuppressions

Die -Eigenschaft gibt an, ob unnötige Unterdrückungen beim erneuten Generieren der Unterdrückungsdatei zulässig sind. Wenn eine vorhandene Unterdrückungsdatei neu generiert wird, wird der Inhalt gelesen, in eine Reihe von Unterdrückungen deserialisiert und dann in einer Liste gespeichert. Einige der Unterdrückungen sind möglicherweise nicht mehr erforderlich, wenn die Inkompatibilität behoben wurde. Wenn die Unterdrückungen wieder auf dem Datenträger serialisiert werden, können Sie auswählen, dass alle vorhandenen (deserialisierten) Ausdrücke beibehalten werden, indem Sie diese Eigenschaft auf festlegen.

Der Standardwert ist .

<PropertyGroup>
  <ApiCompatPreserveUnnecessarySuppressions>true</ApiCompatPreserveUnnecessarySuppressions>
</PropertyGroup>

ApiCompatRespectInternals

Die -Eigenschaft gibt an, ob -APIs zusätzlich zu -APIs auf Kompatibilität überprüft werden sollen.

<PropertyGroup>
  <ApiCompatRespectInternals>true</ApiCompatRespectInternals>
</PropertyGroup>

ApiCompatSuppressionFile

Das -Element gibt den Pfad zu einer oder mehreren Unterdrückungsdateien an, aus der/denen gelesen werden soll. Wenn keine Angabe erfolgt, wird die Unterdrückungsdatei project-directory/CompatibilitySuppressions.xml gelesen (sofern vorhanden).

<ItemGroup>
  <ApiCompatSuppressionFile Include="CompatibilitySuppressions.xml;CompatibilitySuppressions.WasmThreads.xml" />
</ItemGroup>

ApiCompatSuppressionOutputFile

Die -Eigenschaft gibt den Pfad zu einer Unterdrückungsdatei an, in die geschrieben werden soll, wenn auf festgelegt ist. Ohne Angabe wird das erste -Element verwendet.

EnablePackageValidation

Die Eigenschaft aktiviert eine Reihe von Überprüfungen für das Paket nach der -Aufgabe. Weitere Informationen finden Sie unter Paketüberprüfung.

<PropertyGroup>
  <EnablePackageValidation>true</EnablePackageValidation>
</PropertyGroup>

EnableStrictModeForBaselineValidation

Bei Festlegung auf aktiviert die -Eigenschaft den Strict-Modus für Paketbasisüberprüfungen. Der Standardwert ist .

EnableStrictModeForCompatibleFrameworksInPackage

Bei Festlegung auf aktiviert die -Eigenschaft den Strict-Modus für Assemblys, die basierend auf ihrem Zielframework kompatibel sind. Der Standardwert ist .

EnableStrictModeForCompatibleTfms

Bei Festlegung auf aktiviert die -Eigenschaft den Strict-Modus für Vertrags- und Implementierungsassemblys für alle kompatiblen Zielframeworks. Der Standardwert ist .

NoWarn

Die -Eigenschaft gibt die zu unterdrückenden Diagnose-IDs an.

<PropertyGroup>
  <NoWarn>$(NoWarn);PKV0001</NoWarn>
</PropertyGroup>

PackageValidationBaselineFrameworkToIgnore

Das -Element gibt ein Zielframework an, das vom Basispaket ignoriert werden soll. Die Frameworkzeichenfolge muss exakt mit dem Ordnernamen im Basispaket übereinstimmen.

<ItemGroup>
  <PackageValidationBaselineFrameworkToIgnore Include="netcoreapp2.1" />
</ItemGroup>

PackageValidationBaselineName

Die -Eigenschaft gibt den Namen des Basispakets an, anhand dessen das aktuelle Paket überprüft werden soll. Ohne Angabe wird der Wert verwendet.

PackageValidationBaselineVersion

Die -Eigenschaft gibt die Version des Basispakets an, anhand dessen das aktuelle Paket überprüft werden soll.

PackageValidationReferencePath

Das -Element gibt den Verzeichnispfad an, in dem die Referenzassembly pro TFM gefunden werden kann.

<ItemGroup>
  <PackageValidationReferencePath Include="path/to/reference-assembly" TargetFramework="net9.0" />
</ItemGroup>

RoslynAssembliesPath

Die -Eigenschaft gibt den Pfad zum Verzeichnis an, das die Microsoft.CodeAnalysis-Assemblys enthält, die Sie verwenden möchten. Sie müssen diese Eigenschaft nur festlegen, wenn Sie zum Testen einen neueren Compiler als den verwenden möchten, der im SDK enthalten ist.

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

AppendRuntimeIdentifierToOutputPath
AppendTargetFrameworkToOutputPath
CopyLocalLockFileAssemblies
ErrorOnDuplicatePublishOutputFiles
GenerateRuntimeConfigDevFile
GenerateRuntimeConfigurationFiles
GenerateSatelliteAssembliesForCore
IsPublishable
PreserveCompilationContext
PreserveCompilationReferences
ProduceReferenceAssemblyInOutDir
PublishDocumentationFile
PublishDocumentationFiles
PublishReferencesDocumentationFiles
PublishReferencesSymbols
PublishRelease
PublishSelfContained
RollForward
RuntimeFrameworkVersion
RuntimeIdentifier
RuntimeIdentifiers
SatelliteResourceLanguages
SelfContained
UseAppHost

AppendTargetFrameworkToOutputPath

Die -Eigenschaft steuert, ob der Zielframeworkmoniker (TFM, Target Framework Moniker) an den Ausgabepfad angehängt wird, der durch OutputPath definiert wird. Das .NET SDK fügt automatisch das Zielframework an und fügt, falls vorhanden, den Laufzeitbezeichner an den Ausgabepfad an. Wenn Sie auf festlegen, wird verhindert, dass der Zielframeworkmoniker an den Ausgabepfad angefügt wird. Jedoch überschreiben sich ohne den Zielframeworkmoniker im Ausgabepfad mehrere Buildartefakte gegenseitig.

Bei einer .NET 5-App ändert sich der Ausgabepfad beispielsweise von bin\Debug\net5.0 in bin\Debug mit der folgenden Einstellung:

<PropertyGroup>
  <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
</PropertyGroup>

AppendRuntimeIdentifierToOutputPath

Die -Eigenschaft steuert, ob der Runtimebezeichner (RID, Runtime Identifier) an den Ausgabepfad angefügt wird. Das .NET SDK fügt das Zielframework automatisch an und fügt, falls vorhanden, den Laufzeitbezeichner (RID) an den Ausgabepfad an. Wenn Sie auf festlegen, wird verhindert, dass der Runtimebezeichner an den Ausgabepfad angefügt wird. (Die RID wird jedoch weiterhin an den Veröffentlichungspfad angefügt. Weitere Informationen finden Sie unter dotnet/sdk#12114.)

Bei einer .NET 9-App und einer RID von win-x64 ändert die folgende Einstellung beispielsweise den Ausgabepfad von bin\Debug\net9.0\win-x64 in bin\Debug\net9.0:

<PropertyGroup>
  <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
</PropertyGroup>

CopyLocalLockFileAssemblies

Die Eigenschaft ist nützlich für Plug-In-Projekte, die von anderen Bibliotheken abhängig sind. Wenn Sie diese Eigenschaft auf festlegen, werden alle transitiven NuGet-Paketabhängigkeiten in das Ausgabeverzeichnis kopiert. Das bedeutet, dass Sie die Ausgabe von verwenden können, um das Plug-In auf einem beliebigen Computer auszuführen.

<PropertyGroup>
  <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
</PropertyGroup>

Der Standardwert kann je nach Ausgabetyp variieren. Für Klassenbibliotheken ist der Standardwert z. B. , während der Standardwert für Konsolenanwendungen ist . Sie können diese Eigenschaft explizit angeben, um die Standardeinstellung bei Bedarf außer Kraft zu setzen.

Tip

Alternativ können Sie auch verwenden, um die Klassenbibliothek zu veröffentlichen. Weitere Informationen finden Sie unter dotnet publish.

ErrorOnDuplicatePublishOutputFiles

Die Eigenschaft bezieht sich darauf, ob das SDK den Fehler NETSDK1148 generiert, wenn MSBuild doppelte Dateien in der Veröffentlichungsausgabe erkennt, aber nicht bestimmen kann, welche Dateien entfernt werden sollen. Legen Sie die Eigenschaft auf fest, wenn der Fehler nicht generiert werden soll.

<PropertyGroup>
  <ErrorOnDuplicatePublishOutputFiles>false</ErrorOnDuplicatePublishOutputFiles>
</PropertyGroup>

Diese Eigenschaft wurde in .NET 6 eingeführt.

GenerateRuntimeConfigDevFile

Ab dem .NET 6 SDK wird die datei [Appname].runtimesettings.dev.json zur Kompilierungszeit standardmäßig No longer generiert. Wenn diese Datei trotzdem generiert werden soll, legen Sie die -Eigenschaft auf fest.

<PropertyGroup>
  <GenerateRuntimeConfigDevFile>true</GenerateRuntimeConfigDevFile>
</PropertyGroup>

GenerateRuntimeConfigurationFiles

Die -Eigenschaft steuert, ob Optionen für die Laufzeitkonfiguration aus der Datei runtimeconfig.template.json in die Datei [appname].runtimeconfig.json kopiert werden. Für Apps, die eine runtimeconfig.json-Datei erfordern – also für solche mit als –, ist diese Eigenschaft standardmäßig .

<PropertyGroup>
  <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>
</PropertyGroup>

GenerateSatelliteAssembliesForCore

Die eigenschaft GenerateSatelliteAssembliesForCore steuert, ob Satellitenassemblys mithilfe von csc.exe oder Al.exe (Assembly Linker) in .NET Framework-Projekten generiert werden. (.NET Core- und .NET 5+-Projekte verwenden immer csc.exe zum Generieren von Satellitenassemblys.) Für .NET Framework-Projekte werden Satellitenassemblys standardmäßig von al.exe erstellt. Wenn Sie die -Eigenschaft auf festlegen, werden Satellitenassemblys stattdessen von csc.exe erstellt. Die Verwendung von csc.exe kann in folgenden Situationen von Vorteil sein:

Sie möchten die C#-Compileroption verwenden.
Sie sind durch die Tatsache eingeschränkt, dass al.exe keine Unterstützung für öffentliches Signieren bietet und schlecht verarbeitet.

<PropertyGroup>
  <GenerateSatelliteAssembliesForCore>true</GenerateSatelliteAssembliesForCore>
</PropertyGroup>

IsPublishable

Die Eigenschaft ermöglicht die Ausführung des Ziels . Diese Eigenschaft wirkt sich nur auf Prozesse aus, die *.proj-Dateien und das -Ziel verwenden, z. B. der Befehl dotnet publish. Sie wirkt sich nicht auf die Veröffentlichung in Visual Studio aus, die das Ziel PublishOnly verwendet. Standardwert: .

Diese Eigenschaft ist nützlich, wenn Sie für eine Lösungsdatei ausführen, da sie die automatische Auswahl von Projekten ermöglicht, die veröffentlicht werden sollen.

<PropertyGroup>
  <IsPublishable>false</IsPublishable>
</PropertyGroup>

PreserveCompilationContext

Die Eigenschaft ermöglicht es einer erstellten oder veröffentlichten Anwendung, mehr Code zur Laufzeit mithilfe der gleichen Einstellungen zu kompilieren, die zur Buildzeit verwendet wurden. Die Assemblys, auf die zur Buildzeit verwiesen wird, werden in das ref-Unterverzeichnis des Ausgabeverzeichnisses kopiert. Die Namen der Verweisassemblys werden in der .deps.json-Datei der Anwendung zusammen mit den Optionen gespeichert, die an den Compiler weitergeleitet werden. Sie können diese Informationen mithilfe der Eigenschaften und abrufen.

Diese Funktionalität wird hauptsächlich intern von ASP.NET Core MVC- und Razor-Seiten verwendet, um die Laufzeitkompilierung von Razor-Dateien zu unterstützen.

<PropertyGroup>
  <PreserveCompilationContext>true</PreserveCompilationContext>
</PropertyGroup>

PreserveCompilationReferences

Die -Eigenschaft ähnelt der PreserveCompilationContext-Eigenschaft, mit der Ausnahme, dass sie nur die referenzierten Assemblys in das Veröffentlichungsverzeichnis kopiert, nicht die .deps.json-Datei.

<PropertyGroup>
  <PreserveCompilationReferences>true</PreserveCompilationReferences>
</PropertyGroup>

Weitere Informationen finden Sie unter Razor SDK-Eigenschaften.

ProduceReferenceAssemblyInOutDir

In .NET 5 und früheren Versionen werden Referenzassemblys immer in das Verzeichnis OutDir geschrieben. In .NET 6 und höheren Versionen können Sie mit der Eigenschaft ProduceReferenceAssemblyInOutDir steuern, ob Verweisassemblys in das Verzeichnis OutDir geschrieben werden. Der Standardwert ist , und Verweisassemblys werden nur in das Verzeichnis geschrieben. Legen Sie den Wert auf fest, um Verweisassemblys in das Verzeichnis zu schreiben.

<PropertyGroup>
  <ProduceReferenceAssemblyInOutDir>true</ProduceReferenceAssemblyInOutDir>
</PropertyGroup>

Weitere Informationen finden Sie unter Schreiben von Verweisassemblys in die Zwischenausgabe.

PublishDocumentationFile

Wenn diese Eigenschaft ist, wird die XML-Dokumentationsdatei für das Projekt, falls eine generiert wird, in die Veröffentlichungsausgabe für das Projekt aufgenommen. Der Standardwert dieser Eigenschaft ist .

Tip

Legen Sie GenerateDocumentationFile auf fest, um zur Kompilierzeit eine XML-Dokumentationsdatei zu generieren.

PublishDocumentationFiles

Diese Eigenschaft ist ein Aktivierungsflag für mehrere andere Eigenschaften, die steuern, ob verschiedene Arten von XML-Dokumentationsdateien standardmäßig in das Veröffentlichungsverzeichnis kopiert werden, nämlich PublishDocumentationFile und PublishReferencesDocumentationFiles. Wenn diese Eigenschaften nicht festgelegt sind, und diese Eigenschaft aber festgelegt ist, werden diese Eigenschaften standardmäßig auf festgelegt. Der Standardwert dieser Eigenschaft ist .

PublishReferencesDocumentationFiles

Wenn diese Eigenschaft lautet , werden XML-Dokumentationsdateien für die Verweise des Projekts in das Veröffentlichungsverzeichnis kopiert, anstatt nur Laufzeitressourcen wie DLL-Dateien. Der Standardwert dieser Eigenschaft ist .

PublishReferencesSymbols

Wenn diese Eigenschaft lautet , werden Symboldateien (auch als PDB-Dateien bezeichnet) für die Verweise des Projekts in das Veröffentlichungsverzeichnis kopiert, anstatt nur Laufzeitressourcen wie DLL-Dateien. Der Standardwert dieser Eigenschaft ist .

PublishRelease

Die -Eigenschaft weist an, die -Konfiguration standardmäßig anstelle der -Konfiguration zu verwenden. Diese Eigenschaft wurde in .NET 7 eingeführt.

<PropertyGroup>
  <PublishRelease>true</PublishRelease>
</PropertyGroup>

Note

Ab dem .NET 8 SDK ist standardmäßig PublishRelease standardmäßig auf true für Projekte festgelegt, die auf .NET 8 oder höher abzielen. Weitere Informationen finden Sie unter „dotnet publish“ verwendet die Releasekonfiguration.
Diese Eigenschaft wirkt sich nicht auf das Verhalten von dotnet build /t:Publish aus und ändert die Konfiguration nur, wenn sie über die .NET CLI veröffentlicht wird.

PublishSelfContained

Die Eigenschaft informiert , eine App als eigenständige App zu veröffentlichen. Diese Eigenschaft ist nützlich, wenn Sie das Argument für den Befehl dotnet publish nicht verwenden können, z. B. wenn Sie auf Lösungsebene veröffentlichen. In diesem Fall können Sie die MSBuild-Eigenschaft zu einer Projekt- oder Directory.Build.Props-Datei hinzufügen.

Diese Eigenschaft wurde in .NET 7 eingeführt. Dies ähnelt der Eigenschaft SelfContained, mit der Ausnahme, dass sie für das Verb spezifisch ist. Es wird empfohlen, anstelle von zu verwenden.

<PropertyGroup>
  <PublishSelfContained>true</PublishSelfContained>
</PropertyGroup>

RollForward

Die Eigenschaft steuert, wie die Anwendung eine Runtime auswählt, wenn mehrere Runtimeversionen verfügbar sind. Dieser Wert wird als -Einstellung an ausgegeben.

<PropertyGroup>
  <RollForward>LatestMinor</RollForward>
</PropertyGroup>

Legen Sie auf einen der folgenden Werte fest:

Value	Description
`Minor`	Standard, wenn nicht angegeben. Rollforward auf die nächste verfügbare höhere Nebenversion (und höchste verfügbare Patchversion innerhalb dieser Nebenversion), wenn die angeforderte Nebenversion fehlt. Ist die angeforderte Nebenversion vorhanden, wird die Richtlinie verwendet.
`Major`	Rollforward auf die nächste verfügbare höhere Hauptversion (mit der niedrigsten verfügbaren Nebenversion und der höchsten verfügbaren Patchversion innerhalb dieser Nebenversion), wenn die angeforderte Hauptversion fehlt. Ist die angeforderte Hauptversion vorhanden, wird die Richtlinie verwendet.
`LatestPatch`	Aktualisieren Sie auf die höchste verfügbare Patch-Version für die angeforderten Haupt- und Nebenversionen. Mit diesem Wert wird ein Rollforward zur Nebenversion deaktiviert.
`LatestMinor`	Rollforward auf die höchste für die angeforderte Hauptversion verfügbare Nebenversion (und die höchste verfügbare Patchversion innerhalb dieser Nebenversion), auch wenn die angeforderte Nebenversion vorhanden ist.
`LatestMajor`	Rollforward auf die höchste verfügbare Hauptversion (und die höchste innerhalb dieser Hauptversion verfügbare Neben- und Patchversion), auch wenn die angeforderte Hauptversion vorhanden ist.
`Disable`	Es erfolgt kein Rollforward, sondern nur eine Bindung an die angegebene Version. Diese Richtlinie wird nicht zur allgemeinen Verwendung empfohlen, da sie die Möglichkeit eines Rollforwards zu den neuesten Patches deaktiviert. Dieser Wert wird nur zu Testzwecken empfohlen.

Weitere Informationen finden Sie unter Steuern des Rollforwardverhaltens.

RuntimeFrameworkVersion

Die Eigenschaft gibt die Version der Runtime an, die beim Veröffentlichen verwendet werden soll. Geben Sie eine Runtimeversion an:

<PropertyGroup>
  <RuntimeFrameworkVersion>5.0.7</RuntimeFrameworkVersion>
</PropertyGroup>

Beim Veröffentlichen einer frameworkabhängigen Anwendung gibt dieser Wert die mindestens erforderliche Version an. Beim Veröffentlichen einer eigenständigen Anwendung gibt dieser Wert die genaue erforderliche Version an.

RuntimeIdentifier

Mit der Eigenschaft können Sie eine einzelne Runtime-ID (RID) für das Projekt angeben. RIDs ermöglichen das Veröffentlichen einer eigenständigen Bereitstellung.

<PropertyGroup>
  <RuntimeIdentifier>linux-x64</RuntimeIdentifier>
</PropertyGroup>

RuntimeIdentifiers

Mit der Eigenschaft können Sie eine durch Semikolons getrennte Liste von Runtime-IDs (RIDs) für das Projekt angeben. Verwenden Sie diese Eigenschaft, wenn die Veröffentlichung für mehrere Runtimes erfolgen muss. wird zur Wiederherstellungszeit verwendet, um sicherzustellen, dass sich die richtigen Assets im Graph befinden.

Tip

(Singular) kann schnellere Builds bereitstellen, wenn nur eine einzige Runtime erforderlich ist.

<PropertyGroup>
  <RuntimeIdentifiers>win-x64;osx-x64;linux-x64</RuntimeIdentifiers>
</PropertyGroup>

SatelliteResourceLanguages

Mit der -Eigenschaft können Sie angeben, für welche Sprachen die Satellitenressourcenassemblys während der Erstellung und Veröffentlichung beibehalten werden sollen. Viele NuGet-Pakete enthalten lokalisierte Satellitenressourcenassemblys im Hauptpaket. Bei Projekten, die auf diese NuGet-Pakete verweisen, die keine lokalisierten Ressourcen erfordern, können die lokalisierten Assemblys die Build- und Veröffentlichungsausgabe unnötig vergrößern. Durch Hinzufügen der -Eigenschaft zu Ihrer Projektdatei werden nur lokalisierte Assemblys für die von Ihnen angegebenen Sprachen in die Build- und Veröffentlichungsausgabe aufgenommen. In der folgenden Projektdatei bleiben beispielsweise nur die Ressourcensatellitenassemblys für Englisch (USA) und Deutsch (Deutschland) erhalten.

<PropertyGroup>
  <SatelliteResourceLanguages>en-US;de-DE</SatelliteResourceLanguages>
</PropertyGroup>

Note

Sie müssen diese Eigenschaft in dem Projekt angeben, das auf das NuGet-Paket mit lokalisierten Satellitenressourcenassemblys verweist.
Um mehrere Sprachen als Argument von anzugeben, müssen Sie die Sprachbezeichner in drei Anführungszeichenpaare einschließen. Beispiel:

dotnet msbuild multi.msbuildproj -p:SatelliteResourceLanguages="""de;en"""

SelfContained

Die Eigenschaft informiert und eine App als eigenständige App zu erstellen oder zu veröffentlichen. Diese Eigenschaft ist nützlich, wenn Sie das Argument nicht mit dem Befehl dotnet verwenden können, z. B. wenn Sie auf Lösungsebene veröffentlichen. In diesem Fall können Sie die MSBuild-Eigenschaft zu einer Projekt- oder Directory.Build.Props-Datei hinzufügen.

Diese Eigenschaft ähnelt der PublishSelfContained-Eigenschaft. Es wird empfohlen, wenn möglich anstelle von zu verwenden.

<PropertyGroup>
  <SelfContained>true</SelfContained>
</PropertyGroup>

UseAppHost

Die -Eigenschaft steuert, ob eine native ausführbare Datei für eine Bereitstellung erstellt wird. Eine native ausführbare Datei ist für eigenständige Bereitstellungen erforderlich. Standardmäßig wird eine frameworkabhängige ausführbare Datei erstellt. Legen Sie die Eigenschaft auf fest, um die Erzeugung der ausführbaren Datei zu deaktivieren.

<PropertyGroup>
  <UseAppHost>false</UseAppHost>
</PropertyGroup>

Weitere Informationen zur Bereitstellung finden Sie unter .NET Anwendungsbereitstellung.

Zahlreiche MSBuild-Eigenschaften stehen zur Optimierung des Kürzens zur Verfügung, wobei es sich um ein Feature handelt, mit dem nicht verwendeter Code aus eigenständigen Bereitstellungen gekürzt wird. Diese Optionen werden detailliert unter Kürzungsoptionen erläutert. Die folgende Tabelle enthält eine Kurzübersicht.

Property	Values	Description
`PublishTrimmed`	oder	Steuert, ob das Kürzen während der Veröffentlichung aktiviert ist.
`TrimMode`	oder	Der Standardwert ist . Steuert die Granularität der Kürzung.
`SuppressTrimAnalysisWarnings`	oder	Steuert, ob Kürzungsanalysewarnungen erzeugt werden.
`EnableTrimAnalyzer`	oder	Steuert, ob eine Untermenge von Kürzungsanalysewarnungen erzeugt wird. Sie können die Analyse selbst dann aktivieren, wenn auf festgelegt ist.
`ILLinkTreatWarningsAsErrors`	oder	Steuert, ob Kürzungswarnungen als Fehler behandelt werden. Beispielsweise können Sie diese Eigenschaft auf festlegen, wenn auf festgelegt ist.
`TrimmerSingleWarn`	oder	Steuert, ob eine einzelne Warnung pro Assembly oder alle Warnungen angezeigt werden.
`TrimmerRemoveSymbols`	oder	Steuert, ob alle Symbole aus einer gekürzten Anwendung entfernt werden.

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

ContinuousIntegrationBuild
CopyDebugSymbolFilesFromPackages
CopyDocumentationFilesFromPackages
DisableImplicitFrameworkDefines
DocumentationFile
EmbeddedResourceUseDependentUponConvention
EnablePreviewFeatures
EnableWindowsTargeting
GenerateDocumentationFile
GenerateRequiresPreviewFeaturesAttribute
OptimizeImplicitlyTriggeredBuild
DisableRuntimeMarshalling
BuildWithNetFrameworkHostedCompiler
RoslynCompilerType

C#-Compileroptionen wie zum Beispiel und können auch als MSBuild-Eigenschaften in Ihrer Projektdatei angegeben werden. Weitere Informationen finden Sie unter C#-Compileroptionen.

ContinuousIntegrationBuild

Die -Eigenschaft zeigt an, ob ein Build auf einem CI-Server (Continuous Integration) ausgeführt wird. Wenn diese Eigenschaft auf c festgelegt ist, aktiviert sie Einstellungen, die nur für offizielle Builds gelten, nicht für lokale Builds auf einem Entwicklercomputer. Gespeicherte Dateipfade werden beispielsweise für offizielle Builds normalisiert. Auf einem lokalen Entwicklungscomputer kann der Debugger jedoch keine lokalen Quelldateien finden, wenn Dateipfade normalisiert werden.

Sie können die Variable Ihres CI-Systems verwenden, um die -Eigenschaft bedingt festzulegen. Der Variablename für Azure Pipelines lautet z. B. TF_BUILD:

<PropertyGroup Condition="'$(TF_BUILD)' == 'true'">
  <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
</PropertyGroup>

Für GitHub Actions ist der Variablenname GITHUB_ACTIONS:

<PropertyGroup Condition="'$(GITHUB_ACTIONS)' == 'true'">
  <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
</PropertyGroup>

CopyDebugSymbolFilesFromPackages

Wenn diese Eigenschaft auf festgelegt ist, werden alle Symboldateien (auch als PDB-Dateien bezeichnet) aus -Elementen im Projekt in die Buildausgabe kopiert. Diese Dateien können informativere Stapelablaufverfolgungen für Ausnahmen bereitstellen und das Verständnis von Speicherabbildern und Ablaufverfolgungen der ausgeführten Anwendung erleichtern. Die Aufnahme dieser Dateien führt jedoch zu einer Vergrößerung des Bereitstellungspakets.

Diese Eigenschaft wurde in .NET SDK 7.0.100 eingeführt, obwohl sie standardmäßig nicht angegeben wird.

CopyDocumentationFilesFromPackages

Wenn diese Eigenschaft auf festgelegt ist, werden alle generierten XML-Dokumentationsdateien aus -Elementen im Projekt in die Buildausgabe kopiert. Beachten Sie, dass die Aktivierung dieses Features zu einer Vergrößerung des Bereitstellungspakets führt.

Diese Eigenschaft wurde in .NET SDK 7.0.100 eingeführt, obwohl sie standardmäßig nicht angegeben wird.

DisableImplicitFrameworkDefines

Die eigenschaft DisableImplicitFrameworkDefines steuert, ob das SDK Präprozessorsymbole für das Zielframework und die Plattform für das .NET Projekt generiert. Wenn diese Eigenschaft auf festgelegt oder nicht festgelegt ist (der Standardwert), werden Präprozessorsymbole für Folgendes generiert:

Framework ohne Version (, , )
Framework mit Version (, , )
Framework mit Mindestversionsgrenze (, , )

Weitere Informationen zu Zielframeworkmonikern und diesen impliziten Präprozessorsymbolen finden Sie unter Zielframeworks.

Wenn Sie außerdem ein betriebssystemspezifisches Zielframework im Projekt angeben (z. B. ), werden die folgenden Präprozessorsymbole generiert:

Plattform ohne Version (, , )
Plattform mit Version ()
Plattform mit Mindestversionsgrenze ()

Weitere Informationen zu betriebssystemspezifischen Zielframeworkmonikern finden Sie unter Betriebssystemspezifische TFMs.

Schließlich, wenn Ihr Zielframework Unterstützung für ältere Zielframeworks impliziert, werden Präprozessorsymbole für diese älteren Frameworks ausgegeben. Zum Beispiel impliziert, dass Unterstützung für usw. auf dem ganzen Weg zurück zu . Daher wird für jedes dieser Zielframeworks das Symbol Framework mit Mindestversionsgrenze definiert.

DocumentationFile

Mit der -Eigenschaft können Sie einen Dateinamen für die XML-Datei angeben, die die Dokumentation für Ihre Bibliothek enthält. Damit IntelliSense ordnungsgemäß mit Ihrer Dokumentation funktioniert, muss der Dateiname mit dem Assemblynamen identisch sein und sich im gleichen Verzeichnis wie die Assembly befinden. Wenn Sie diese Eigenschaft nicht angeben, aber GenerateDocumentationFile auf festlegen, wird der Name der Dokumentationsdatei standardmäßig auf den Namen Ihrer Assembly festgelegt, jedoch mit der Dateierweiterung .xml. Aus diesem Grund ist es oft einfacher, diese Eigenschaft auszulassen und stattdessen die GenerateDocumentationFile-Eigenschaft zu verwenden.

Wenn Sie diese Eigenschaft angeben, aber GenerateDocumentationFile auf festlegen, generiert der Compiler keine Dokumentationsdatei. Wenn Sie diese Eigenschaft angeben und die GenerateDocumentationFile-Eigenschaft auslassen, generiert der Compiler eine Dokumentationsdatei.

<PropertyGroup>
  <DocumentationFile>path/to/file.xml</DocumentationFile>
</PropertyGroup>

EmbeddedResourceUseDependentUponConvention

Die -Eigenschaft definiert, ob Namen für Ressourcenmanifestdateien aus Typinformationen in Quelldateien generiert werden, die sich im selben Ordner wie die Ressourcendateien befinden. Wenn sich beispielsweise Form1.resx im selben Ordner wie Form1.cs befindet und auf festgelegt ist, nimmt die generierte .resources-Datei den Namen des ersten Typs an, der in Form1.cs definiert ist. Wenn der erste in Form1.cs definierte Typ ist, lautet der generierte Dateiname MyNamespace.Form1.resources.

Note

Wenn -, - oder -Metadaten für ein -Element angegeben werden, basiert der generierte Manifestdateiname für diese Ressourcendatei stattdessen auf diesen Metadaten.

In einem neuen .NET Projekt, das auf .NET Core 3.0 oder höher ausgerichtet ist, wird diese Eigenschaft standardmäßig auf true festgelegt. Wenn bei Festlegung auf keine -, - oder -Metadaten für das -Element in der Projektdatei angegeben werden, basiert der Ressourcenmanifest-Dateiname auf dem Stammnamespace für das Projekt und dem relativen Dateipfad zur .resx-Datei. Weitere Informationen finden Sie unter Benennung von Ressourcenmanifestdateien.

<PropertyGroup>
  <EmbeddedResourceUseDependentUponConvention>true</EmbeddedResourceUseDependentUponConvention>
</PropertyGroup>

EnablePreviewFeatures

Die -Eigenschaft definiert, ob Ihr Projekt von APIs oder Assemblys abhängig ist, die das Attribut aufweisen. Mit diesem Attribut wird angegeben, dass eine API oder Assembly Features verwendet, die für die verwendete SDK-Version als in der Vorschau befindlich betrachtet werden. Vorschaufeatures werden nicht unterstützt und können in einer zukünftigen Version entfernt werden. Um die Verwendung von Vorschaufeatures zu aktivieren, legen Sie die Eigenschaft auf fest.

<PropertyGroup>
  <EnablePreviewFeatures>True</EnablePreviewFeatures>
</PropertyGroup>

Wenn diese Eigenschaft in einem Projekt auf festgelegt ist, wird der Datei AssemblyInfo.cs das folgende Attribut auf Assemblyebene hinzugefügt:

[assembly: RequiresPreviewFeatures]

Ein Analysetool gibt eine Warnung aus, wenn dieses Attribut in Abhängigkeiten für Projekte vorhanden ist, bei denen nicht auf festgelegt ist.

Bibliotheksautoren, die Vorschauassemblys ausliefern möchten, sollten diese Eigenschaft auf festlegen. Wenn Sie eine Assembly sowohl mit Vorschau- als auch mit Nicht-Vorschau-APIs ausliefern müssen, lesen Sie den Abschnitt GenerateRequiresPreviewFeaturesAttribute weiter unten.

EnableWindowsTargeting

Legen Sie die eigenschaft EnableWindowsTargeting auf true fest, um Windows Apps (z. B. Windows Forms- oder Windows Presentation Foundation-Apps) auf einer Nicht-Windows-Plattform zu erstellen. Wenn Sie diese Eigenschaft nicht auf festlegen, erhalten Sie die Buildwarnung NETSDK1100. Dieser Fehler tritt auf, weil Zielversions- und Runtimepakete nicht automatisch auf Plattformen heruntergeladen werden, die nicht unterstützt werden. Wenn Sie diese Eigenschaft festlegen, werden diese Pakete bei Crosstargeting (abweichende Zielversion) heruntergeladen.

Note

Diese Eigenschaft wird derzeit empfohlen, die Entwicklung auf Nicht-Windows-Plattformen zuzulassen. Aber wenn die Anwendung für die Veröffentlichung bereit ist, sollte sie auf Windows basieren. Wenn Sie auf einer Plattform ohne Windows aufbauen, ist die Ausgabe möglicherweise nicht identisch mit dem Erstellen von Windows. Insbesondere wird die ausführbare Datei nicht als Windows-Anwendung markiert (was bedeutet, dass sie immer ein Konsolenfenster startet) und kein Symbol eingebettet ist.

<PropertyGroup>
  <EnableWindowsTargeting>true</EnableWindowsTargeting>
</PropertyGroup>

GenerateDocumentationFile

Die -Eigenschaft steuert, ob der Compiler eine XML-Dokumentationsdatei für Ihre Bibliothek generiert. Wenn Sie diese Eigenschaft auf festlegen und keinen Dateinamen über die Eigenschaft DocumentationFile angeben, wird die generierte XML-Datei im gleichen Ausgabeverzeichnis wie Ihre Assembly platziert und weist den gleichen Dateinamen auf (jedoch mit einer Erweiterung .xml).

<PropertyGroup>
  <GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>

Weitere Informationen zum Generieren von Dokumentationen aus Codekommentaren finden Sie unter XML-Dokumentationskommentare (C#), Dokumentieren Sie Ihren Code mit XML (Visual Basic) oder Dokumentieren Sie Ihren Code mit XML (F#).

GenerateRequiresPreviewFeaturesAttribute

Die -Eigenschaft ist eng mit der EnablePreviewFeatures-Eigenschaft verknüpft. Wenn Ihre Bibliothek Vorschaufeatures verwendet, Sie aber nicht möchten, dass die gesamte Assembly mit dem Attribut gekennzeichnet wird – was erfordert, dass alle Consumer Vorschaufeatures aktivieren –, legen Sie diese Eigenschaft auf fest.

<PropertyGroup>
    <EnablePreviewFeatures>True</EnablePreviewFeatures>
    <GenerateRequiresPreviewFeaturesAttribute>False</GenerateRequiresPreviewFeaturesAttribute>
</PropertyGroup>

Important

Wenn Sie die -Eigenschaft auf festlegen, müssen Sie sicherstellen, dass alle öffentlichen APIs, die Vorschaufeatures nutzen, aufweisen.

OptimizeImplicitlyTriggeredBuild

Um die Buildzeit zu beschleunigen, werden Builds, die implizit von Visual Studio Codeanalyse ausgelöst werden, einschließlich nullfähiger Analyse, ausgelöst. Visual Studio löst einen impliziten Build aus, wenn Sie z. B. Tests ausführen. Implizite Builds werden jedoch nur optimiert, wenn nicht ist. Wenn Sie auf festgelegt haben, aber dennoch implizit ausgelöste Builds optimieren möchten, können Sie auf festlegen. Um die Buildoptimierung für implizit ausgelöste Builds zu deaktivieren, legen Sie auf fest.

<PropertyGroup>
    <OptimizeImplicitlyTriggeredBuild>True</OptimizeImplicitlyTriggeredBuild>
</PropertyGroup>

DisableRuntimeMarshalling

Mit der -Eigenschaft können Sie angeben, dass Sie die Marshallingunterstützung der Runtime für Ihr Projekt deaktivieren möchten. Wenn diese Eigenschaft auf festgelegt ist, wird der Assembly das hinzugefügt, und alle auf P/Invokes oder Delegate basierenden Interops folgen den Regeln für deaktiviertes Runtimemarshalling.

<PropertyGroup>
    <DisableRuntimeMarshalling>True</DisableRuntimeMarshalling>
</PropertyGroup>

BuildWithNetFrameworkHostedCompiler

Die Angabe ist das Äquivalent zum Angeben von . Weitere Informationen finden Sie unter RoslynCompilerType. Die Angabe stellt sicher, dass die automatische Anmeldung nicht erfolgt. Wenn explizit angegeben wird, hat dies keine Auswirkung.

RoslynCompilerType

Die Eigenschaft RoslynCompilerType steuert die Version des C#- oder Visual Basic Compilers. Die folgenden Werte werden erkannt:

Core: Verwenden Sie den Compiler, der im Lieferumfang des .NET SDK enthalten ist. Dies ist der Standardwert seit .NET 10, auch wenn .NET Framework MSBuild verwendet wird.
Framework: Verwenden Sie den Compiler, der im Lieferumfang von .NET Framework MSBuild enthalten ist.
FrameworkPackage: Wenn Sie .NET Framework MSBuild verwenden, laden Sie ein Paket mit dem .NET Framework-Compiler herunter, der der .NET SDK-Version entspricht.

Standardeigenschaften für den Elementeinschluss

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

DefaultItemExcludesInProjectFolder
DefaultItemExcludes
EnableDefaultCompileItems
EnableDefaultEmbeddedResourceItems
EnableDefaultItems
EnableDefaultNoneItems

Weitere Informationen finden Sie unter dem Abschnitt zu standardmäßigen Include- und Excludedateien.

DefaultItemExcludes

Verwenden Sie die -Eigenschaft, um Globmuster für Dateien und Ordner zu definieren, die aus der Include- und Excludedatei sowie Remove-Globs ausgeschlossen werden sollen. Standardmäßig werden die Ordner ./bin und ./obj aus den Globmustern ausgeschlossen.

<PropertyGroup>
  <DefaultItemExcludes>$(DefaultItemExcludes);**/*.myextension</DefaultItemExcludes>
</PropertyGroup>

Note

Die Eigenschaft schließt Dateien und Ordner von der Überwachung aus . Weitere Informationen finden Sie unter Ignorieren angegebener Ordner und Dateien von .

DefaultItemExcludesInProjectFolder

Verwenden Sie die -Eigenschaft, um Globmuster für Dateien und Ordner im Projektordner zu definieren, die aus der Include- und Excludedatei sowie Remove-Globs ausgeschlossen werden sollen. Standardmäßig werden Ordner, die mit einem Punkt () beginnen, z. B. .git und .vs, aus den Globmustern ausgeschlossen.

Diese Eigenschaft ähnelt der -Eigenschaft, mit der Ausnahme, dass sie nur Dateien und Ordner im Projektordner berücksichtigt. Wenn ein Globmuster versehentlich mit Elementen außerhalb des Projektordners mit einem relativen Pfad übereinstimmen würde, verwenden Sie die -Eigenschaft anstelle der -Eigenschaft.

<PropertyGroup>
  <DefaultItemExcludesInProjectFolder>$(DefaultItemExcludesInProjectFolder);**/myprefix*/**</DefaultItemExcludesInProjectFolder>
</PropertyGroup>

EnableDefaultItems

Die -Eigenschaft steuert, ob Kompilierungselemente, eingebettete Ressourcenelemente und -Elemente implizit in das Projekt eingeschlossen werden. Standardwert: . Um jedes implizite Einbeziehen von Dateien zu deaktivieren, legen Sie die -Eigenschaft auf fest.

<PropertyGroup>
  <EnableDefaultItems>false</EnableDefaultItems>
</PropertyGroup>

EnableDefaultCompileItems

Die -Eigenschaft steuert, ob Kompilierungselemente implizit in das Projekt eingeschlossen werden. Standardwert: . Legen Sie die -Eigenschaft auf fest, um die implizite Einbindung von *.cs-Dateien und anderen Spracherweiterungsdateien zu deaktivieren.

<PropertyGroup>
  <EnableDefaultCompileItems>false</EnableDefaultCompileItems>
</PropertyGroup>

EnableDefaultEmbeddedResourceItems

Die -Eigenschaft steuert, ob eingebettete Ressourcenelemente implizit in das Projekt eingeschlossen werden. Standardwert: . Legen Sie die -Eigenschaft auf fest, um die implizite Einbindung eingebetteter Ressourcendateien zu deaktivieren.

<PropertyGroup>
  <EnableDefaultEmbeddedResourceItems>false</EnableDefaultEmbeddedResourceItems>
</PropertyGroup>

EnableDefaultNoneItems

Die -Eigenschaft steuert, ob -Elemente (Dateien, die keine Rolle im Buildprozess aufweisen) implizit in das Projekt eingeschlossen werden. Standardwert: . Legen Sie die -Eigenschaft auf fest, um die implizite Einbindung von -Elementen zu deaktivieren.

<PropertyGroup>
  <EnableDefaultNoneItems>false</EnableDefaultNoneItems>
</PropertyGroup>

Codeanalyseeigenschaften

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

AnalysisLevel
AnalysisLevelKategorie
AnalysisMode
AnalysisModeKategorie
CodeAnalysisTreatWarningsAsErrors
EnableNETAnalyzers
EnforceCodeStyleInBuild
_SkipUpgradeNetAnalyzersNuGetWarning

AnalysisLevel

Mit der Eigenschaft AnalysisLevel können Sie eine Reihe von Codeanalyses angeben, die gemäß einer .NET Version ausgeführt werden sollen. Jede .NET Version verfügt über eine Reihe von Codeanalyseregeln. Von diesem Satz werden die Regeln, die standardmäßig für diese Version aktiviert sind, Ihren Code analysieren. Wenn Sie beispielsweise ein Upgrade von .NET 8 auf .NET 9 durchführen, aber nicht möchten, dass sich der Standardsatz von Codeanalyseregeln ändern soll, legen Sie AnalysisLevel auf 8 fest.

<PropertyGroup>
  <AnalysisLevel>8</AnalysisLevel>
</PropertyGroup>

Optional können Sie einen zusammengesetzten Wert für diese Eigenschaft angeben, der auch angibt, wie aggressiv Regeln aktiviert werden sollen. Verbundwerte haben die Form , wobei der -Wert einer der AnalysisMode-Werte ist. Im folgenden Beispiel wird die Version von Codeanalysatoren verwendet und der Satz von Regeln aktiviert.

<PropertyGroup>
  <AnalysisLevel>preview-recommended</AnalysisLevel>
</PropertyGroup>

Standardwert:

Wenn Ihr Projekt auf .NET 5 oder höher ausgerichtet ist oder Wenn Sie die Eigenschaft AnalysisMode hinzugefügt haben, ist der Standardwert latest.
Andernfalls wird diese Eigenschaft ausgelassen, es sei denn, Sie fügen sie der Projektdatei explizit hinzu.

In der folgenden Tabelle werden die Werte aufgeführt, die Sie angeben können.

Value	Meaning
`latest`	Die neuesten Codeanalysen, die veröffentlicht wurden, werden verwendet. Dies ist die Standardoption.
`latest-<mode>`	Die neuesten Codeanalysen, die veröffentlicht wurden, werden verwendet. Der -Wert bestimmt, welche Regeln aktiviert sind.
`preview`	Die neuesten Codeanalysetools werden verwendet, auch wenn sie sich in der Vorschau befinden.
`preview-<mode>`	Die neuesten Codeanalysetools werden verwendet, auch wenn sie sich in der Vorschau befinden. Der -Wert bestimmt, welche Regeln aktiviert sind.
`10.0`	Der Satz von Regeln, die für die .NET 10-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind.
`10.0-<mode>`	Der Satz von Regeln, die für die .NET 10-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind. Der -Wert bestimmt, welche Regeln aktiviert sind.
`10`	Der Satz von Regeln, die für die .NET 10-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind.
`10-<mode>`	Der Satz von Regeln, die für die .NET 10-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind. Der -Wert bestimmt, welche Regeln aktiviert sind.
`9.0`	Der Satz von Regeln, die für die .NET 9-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind.
`9.0-<mode>`	Der Satz von Regeln, die für die .NET 9-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind. Der -Wert bestimmt, welche Regeln aktiviert sind.
`9`	Der Satz von Regeln, die für die .NET 9-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind.
`9-<mode>`	Der Satz von Regeln, die für die .NET 9-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind. Der -Wert bestimmt, welche Regeln aktiviert sind.
`8.0`	Der Satz von Regeln, die für die .NET 8-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind.
`8.0-<mode>`	Der Satz von Regeln, die für die .NET 8-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind. Der -Wert bestimmt, welche Regeln aktiviert sind.
`8`	Der Satz von Regeln, die für die .NET 8-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind.
`8-<mode>`	Der Satz von Regeln, die für die .NET 8-Version verfügbar waren, wird verwendet, auch wenn neuere Regeln verfügbar sind. Der -Wert bestimmt, welche Regeln aktiviert sind.

Note

Wenn Sie "EnforceCodeStyleInBuild" auf "EnforceCodeStyleInBuild, wirkt sich diese Eigenschaft auf Codestilregeln (IDEXXXX) aus (zusätzlich zu Codequalitätsregeln).
Wenn Sie einen Verbundwert für festlegen, müssen Sie keinen AnalysisMode angeben. Wenn Sie jedoch einen Modus angeben, besitzt Vorrang vor .
Diese Eigenschaft hat keine Auswirkungen auf die Codeanalyse in Projekten, die nicht auf ein project SDK verweisen, z. B. ältere .NET Framework-Projekte, die auf das Microsoft.CodeAnalysis.NetAnalyzers NuGet-Paket verweisen. Weitere Informationen finden Sie unter Aktivieren der Codeanalyse in Legacyprojekten.

AnalysisLevelKategorie

Diese Eigenschaft ist mit AnalysisLevel identisch, gilt jedoch nur für eine bestimmte Kategorie von Codeanalyseregeln. Mit dieser Eigenschaft können Sie eine andere Version von Codeanalysetools für eine bestimmte Kategorie verwenden oder Regeln auf einer anderen Ebene als die anderen Regelkategorien aktivieren oder deaktivieren. Wenn Sie diese Eigenschaft für eine bestimmte Kategorie von Regeln auslassen, wird standardmäßig der AnalysisLevel-Wert verwendet. Die verfügbaren Werte sind mit denen für AnalysisLevel identisch.

<PropertyGroup>
  <AnalysisLevelSecurity>preview</AnalysisLevelSecurity>
</PropertyGroup>

<PropertyGroup>
  <AnalysisLevelSecurity>preview-recommended</AnalysisLevelSecurity>
</PropertyGroup>

In der folgenden Tabelle wird der Eigenschaftenname für jede Regelkategorie aufgeführt.

Eigenschaftenname	Regelkategorie
`<AnalysisLevelDesign>`	Entwurfsregeln
`<AnalysisLevelDocumentation>`	Dokumentationsregeln
`<AnalysisLevelGlobalization>`	Globalisierungsregeln
`<AnalysisLevelInteroperability>`	Portabilitäts- und Interoperabilitätsregeln
`<AnalysisLevelMaintainability>`	Verwaltungsregeln
`<AnalysisLevelNaming>`	Benennungsregeln
`<AnalysisLevelPerformance>`	Leistungsregeln
`<AnalysisLevelSingleFile>`	Einzeldateianwendungsregeln
`<AnalysisLevelReliability>`	Zuverlässigkeitsregeln
`<AnalysisLevelSecurity>`	Sicherheitsregeln
`<AnalysisLevelStyle>`	Codeformatregeln (IDEXXXX)
`<AnalysisLevelUsage>`	Verwendungsregeln

AnalysisMode

Das .NET SDK enthält alle "CA"-Codequalitätsregeln. Standardmäßig sind nur some rules aktiviert als Buildwarnungen in jeder .NET Version. Mit der -Eigenschaft können Sie den Satz von Regeln anpassen, der standardmäßig aktiviert ist. Sie können entweder zu einem aggressiveren Analysemodus wechseln, bei dem Sie Regeln einzeln ausschließen können, oder zu einem konservativeren Analysemodus, bei dem Sie sich für bestimmte Regeln entscheiden können. Wenn Sie beispielsweise alle Regeln als Buildwarnungen aktivieren möchten, legen Sie den Wert auf fest.

<PropertyGroup>
  <AnalysisMode>All</AnalysisMode>
</PropertyGroup>

Die folgende Tabelle zeigt die verfügbaren Optionswerte: Sie werden in aufsteigender Reihenfolge der Anzahl der Regeln, die sie aktivieren, aufgeführt.

Value	Description
`None`	Alle Regeln sind deaktiviert. Sie können einzelne Regeln selektiv aktivieren.
`Default`	Standardmodus, bei dem bestimmte Regeln als Buildwarnungen aktiviert sind, werden bestimmte Regeln als Visual Studio-IDE Vorschläge aktiviert, und der Rest wird deaktiviert.
`Minimum`	Aggressiverer Modus als der Modus . Bestimmte Vorschläge, die für die Builderzwingung dringend empfohlen werden, werden als Buildwarnungen aktiviert. Überprüfen Sie die %ProgramFiles%/do tnet/sdk/[version]/Sdks/Microsoft.NET, um zu sehen, welche Regeln dies umfasst. Sdk/analyzers/build/config/analysislevel_[level]_minimum.globalconfigDatei. (Für .NET 7 und frühere Versionen ist die Dateierweiterung .editorconfig.)
`Recommended`	Ein aggressiverer Modus als der -Modus, in dem mehr Regeln als Buildwarnungen aktiviert sind. Überprüfen Sie die %ProgramFiles%/do tnet/sdk/[version]/Sdks/Microsoft.NET, um zu sehen, welche Regeln dies umfasst. Sdk/analyzers/build/config/analysislevel_[level]_recommended.globalconfigdatei. (Für .NET 7 und frühere Versionen ist die Dateierweiterung .editorconfig.)
`All`	Alle Regeln sind als Buildwarnungen aktiviert. Sie können einzelne Regeln deaktivieren. * Die folgenden Regeln sind nicht durch Festlegen von auf oder durch Festlegen von auf aktiviert: CA1017, CA1045, CA1005, CA1014, CA1060, CA1021, und die Codemetrikenanalyseregeln (CA1501, CA1502, CA1505, CA1506, und CA1509). Diese Legacy-Regeln sind möglicherweise in einer zukünftigen Version veraltet. Sie können sie jedoch weiterhin einzeln mithilfe eines -Eintrags aktivieren.

Note

Wenn Sie "EnforceCodeStyleInBuild" auf "EnforceCodeStyleInBuild, wirkt sich diese Eigenschaft auf Codestilregeln (IDEXXXX) aus (zusätzlich zu Codequalitätsregeln).
Wenn Sie einen zusammengesetzten Wert für AnalysisLevel verwenden (z. B. ), können Sie diese Eigenschaft vollständig auslassen. Wenn Sie jedoch beide Eigenschaften angeben, besitzt Vorrang vor .

AnalysisModeKategorie

Diese Eigenschaft ist mit AnalysisMode identisch, gilt jedoch nur für eine bestimmte Kategorie von Codeanalyseregeln. Mit dieser Eigenschaft können Sie Regeln auf einer anderen Ebene als die anderen Regelkategorien aktivieren oder deaktivieren. Wenn Sie diese Eigenschaft für eine bestimmte Kategorie von Regeln auslassen, wird standardmäßig der AnalysisMode-Wert verwendet. Die verfügbaren Werte sind mit denen für AnalysisMode identisch.

<PropertyGroup>
  <AnalysisModeSecurity>All</AnalysisModeSecurity>
</PropertyGroup>

In der folgenden Tabelle wird der Eigenschaftenname für jede Regelkategorie aufgeführt.

Eigenschaftenname	Regelkategorie
`<AnalysisModeDesign>`	Entwurfsregeln
`<AnalysisModeDocumentation>`	Dokumentationsregeln
`<AnalysisModeGlobalization>`	Globalisierungsregeln
`<AnalysisModeInteroperability>`	Portabilitäts- und Interoperabilitätsregeln
`<AnalysisModeMaintainability>`	Verwaltungsregeln
`<AnalysisModeNaming>`	Benennungsregeln
`<AnalysisModePerformance>`	Leistungsregeln
`<AnalysisModeSingleFile>`	Einzeldateianwendungsregeln
`<AnalysisModeReliability>`	Zuverlässigkeitsregeln
`<AnalysisModeSecurity>`	Sicherheitsregeln
`<AnalysisModeStyle>`	Codeformatregeln (IDEXXXX)
`<AnalysisModeUsage>`	Verwendungsregeln

CodeAnalysisTreatWarningsAsErrors

Mit der -Eigenschaft können Sie konfigurieren, ob Warnungen im Rahmen der Codequalitätsanalyse (CAxxxx) als Warnungen behandelt werden und den Build unterbrechen sollen. Wenn Sie beim Erstellen Ihrer Projekte das Flag -warnaserror verwenden, werden .NET Codequalitätsanalyse Warnungen ebenfalls als Fehler behandelt. Wenn Warnungen bei der Codequalitätsanalyse nicht als Fehler behandelt werden sollen, können Sie die MSBuild-Eigenschaft in Ihrer Projektdatei auf festlegen.

<PropertyGroup>
  <CodeAnalysisTreatWarningsAsErrors>false</CodeAnalysisTreatWarningsAsErrors>
</PropertyGroup>

EnableNETAnalyzers

.NET Codequalitätsanalyse ist standardmäßig für Projekte aktiviert, die auf .NET 5 oder höher ausgerichtet sind. Wenn Sie das .NET 5+ SDK verwenden, können Sie .NET Codeanalyse für PROJEKTE im SDK-Stil aktivieren, die auf frühere Versionen von .NET abzielen, indem Sie die eigenschaft EnableNETAnalyzers auf true festlegen. Legen Sie diese Eigenschaft auf fest, um die Codeanalyse in einem beliebigen Projekt zu deaktivieren.

<PropertyGroup>
  <EnableNETAnalyzers>true</EnableNETAnalyzers>
</PropertyGroup>

Note

Diese Eigenschaft gilt speziell für die integrierten Analyzer im .NET 5+ SDK. Sie sollte nicht verwendet werden, wenn Sie ein NuGet-Codeanalysepaket installieren.

EnforceCodeStyleInBuild

.NET Codestilanalyse ist standardmäßig für alle .NET Projekte im Build deaktiviert. Sie können die Codeformatvorlagenanalyse für .NET Projekte aktivieren, indem Sie die Eigenschaft EnforceCodeStyleInBuild auf true festlegen.

<PropertyGroup>
  <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
</PropertyGroup>

Alle Codeformatregeln, die als Warnungen oder Fehler konfiguriert sind, werden beim Build ausgeführt und melden Verstöße.

_SkipUpgradeNetAnalyzersNuGetWarning

Mit der eigenschaft _SkipUpgradeNetAnalyzersNuGetWarning können Sie konfigurieren, ob Sie eine Warnung erhalten, wenn Sie Codeanalysatoren aus einem NuGet-Paket verwenden, das veraltet ist, wenn Sie mit den Codeanalysatoren im neuesten .NET SDK verglichen werden. Die Warnung sieht in etwa wie folgt aus:

Das .NET SDK verfügt über neuere Analyzer mit Version 6.0.0 als die Version "5.0.3" des Pakets "Microsoft.CodeAnalysis.NetAnalyzers". Aktualisieren oder entfernen Sie diesen Paketverweis.

Um diese Warnung zu entfernen und weiterhin die Version der Codeanalysetools im NuGet-Paket zu verwenden, legen Sie in Ihrer Projektdatei auf fest.

<PropertyGroup>
  <_SkipUpgradeNetAnalyzersNuGetWarning>true</_SkipUpgradeNetAnalyzersNuGetWarning>
</PropertyGroup>

Runtimekonfigurationseigenschaften

Sie können manche Verhaltensweisen der Runtime konfigurieren, indem Sie die MSBuild-Eigenschaften in der Projektdatei der App angeben. Informationen zu anderen Konfigurationsmöglichkeiten für das Runtimeverhalten finden Sie unter Konfigurationseinstellungen für die Runtime.

AutoreleasePoolSupport
ConcurrentGarbageCollection
InvariantGlobalization
PredefinedCulturesOnly
RetainVMGarbageCollection
ServerGarbageCollection
ThreadPoolMaxThreads
ThreadPoolMinThreads
TieredCompilation
TieredCompilationQuickJit
TieredCompilationQuickJitForLoops
TieredPGO
UseWindowsThreadPool

AutoreleasePoolSupport

Die -Eigenschaft konfiguriert, ob jeder verwaltete Thread bei Ausführung auf einer unterstützten macOS-Plattform einen impliziten NSAutoreleasePool empfängt. Weitere Informationen finden Sie unter für verwaltete Threads.

<PropertyGroup>
  <AutoreleasePoolSupport>true</AutoreleasePoolSupport>
</PropertyGroup>

ConcurrentGarbageCollection

Mit der -Eigenschaft wird konfiguriert, ob die Garbage Collection im Hintergrund (parallele GC) aktiviert ist. Legen Sie den Wert auf fest, um die Garbage Collection im Hintergrund zu deaktivieren. Weitere Informationen finden Sie unter Garbage Collection im Hintergrund.

<PropertyGroup>
  <ConcurrentGarbageCollection>false</ConcurrentGarbageCollection>
</PropertyGroup>

InvariantGlobalization

Mit der -Eigenschaft wird konfiguriert, ob die App im globalisierungsinvarianten Modus ausgeführt wird, was bedeutet, dass sie keinen Zugriff auf kulturspezifische Daten hat. Legen Sie den Wert auf fest, um die Ausführung im globalisierungsinvarianten Modus zu konfigurieren. Weitere Informationen finden Sie unter Invarianter Modus.

<PropertyGroup>
  <InvariantGlobalization>true</InvariantGlobalization>
</PropertyGroup>

PredefinedCulturesOnly

In .NET 6 und höheren Versionen konfiguriert die eigenschaft PredefinedCulturesOnly, ob Apps andere Kulturen als die invariante Kultur erstellen können, wenn globalization-invariant mode aktiviert ist. Der Standardwert ist . Legen Sie den Wert auf fest, um die Erstellung neuer Kulturen im globalisierungsinvarianten Modus zu erlauben.

<PropertyGroup>
  <PredefinedCulturesOnly>false</PredefinedCulturesOnly>
</PropertyGroup>

Weitere Informationen finden Sie unter Kulturerstellung und Zuordnung von Groß-/Kleinbuchstaben im globalisierungsinvarianten Modus.

RetainVMGarbageCollection

Mit der -Eigenschaft wird der Garbage Collector so konfiguriert, dass gelöschte Speichersegmente in eine Standbyliste eingefügt werden, damit Sie diese zukünftig verwenden oder freigeben können. Wenn der Wert auf festgelegt wird, wird der Garbage Collector angewiesen, die Segmente in eine Standbyliste einzufügen. Weitere Informationen finden Sie unter Beibehalten der VM.

<PropertyGroup>
  <RetainVMGarbageCollection>true</RetainVMGarbageCollection>
</PropertyGroup>

ServerGarbageCollection

Mit der -Eigenschaft wird konfiguriert, ob die Anwendung die Garbage Collection für Arbeitsstationen oder für Server verwendet. Legen Sie den Wert auf fest, um die Garbage Collection für Server zu verwenden. Weitere Informationen finden Sie unter Workstation und Server im Vergleich.

<PropertyGroup>
  <ServerGarbageCollection>true</ServerGarbageCollection>
</PropertyGroup>

ThreadPoolMaxThreads

Mit der -Eigenschaft wird die maximale Threadanzahl für den Arbeitsthreadpool konfiguriert. Weitere Informationen finden Sie unter Maximale Threadanzahl.

<PropertyGroup>
  <ThreadPoolMaxThreads>20</ThreadPoolMaxThreads>
</PropertyGroup>

ThreadPoolMinThreads

Mit der -Eigenschaft wird die minimale Threadanzahl für den Arbeitsthreadpool konfiguriert. Weitere Informationen finden Sie unter Minimale Threadanzahl.

<PropertyGroup>
  <ThreadPoolMinThreads>4</ThreadPoolMinThreads>
</PropertyGroup>

TieredCompilation

Mit der -Eigenschaft wird konfiguriert, ob der JIT-Compiler (Just-in-Time) die mehrstufige Kompilierung verwendet. Legen Sie den Wert auf fest, um die mehrstufige Kompilierung zu deaktivieren. Weitere Informationen finden Sie unter Mehrstufige Kompilierung.

<PropertyGroup>
  <TieredCompilation>false</TieredCompilation>
</PropertyGroup>

TieredCompilationQuickJit

Mit der -Eigenschaft wird konfiguriert, ob der JIT-Compiler Quick JIT verwendet. Legen Sie den Wert auf fest, um Quick JIT zu deaktivieren. Weitere Informationen finden Sie unter Quick JIT.

<PropertyGroup>
  <TieredCompilationQuickJit>false</TieredCompilationQuickJit>
</PropertyGroup>

TieredCompilationQuickJitForLoops

Mit der -Eigenschaft wird konfiguriert, ob der JIT-Compiler Quick JIT für Methoden mit Schleifen verwendet. Legen Sie den Wert auf fest, um Quick JIT für Methoden mit Schleifen zu aktivieren. Weitere Informationen finden Sie unter Quick JIT für Schleifen.

<PropertyGroup>
  <TieredCompilationQuickJitForLoops>true</TieredCompilationQuickJitForLoops>
</PropertyGroup>

TieredPGO

Die -Eigenschaft steuert, ob die dynamische oder gestaffelte profilgesteuerte Optimierung (PGO) aktiviert ist. Legen Sie den Wert auf fest, um die mehrstufige PGO zu aktivieren. Weitere Informationen finden Sie unter Profilgesteuerte Optimierung.

<PropertyGroup>
  <TieredPGO>true</TieredPGO>
</PropertyGroup>

UseWindowsThreadPool

Die eigenschaft UseWindowsThreadPool konfiguriert, ob die Threadpoolthreadverwaltung an den Windows Threadpool delegiert wird (nur Windows). Der Standardwert ist false, in diesem Fall wird der .NET Threadpool verwendet. Weitere Informationen finden Sie unter Windows Threadpool.

<PropertyGroup>
  <UseWindowsThreadPool>true</UseWindowsThreadPool>
</PropertyGroup>

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

AssetTargetFallback
DisableImplicitFrameworkReferences
DisableTransitiveFrameworkReferenceDownloads
DisableTransitiveProjectReferences
ManagePackageVersionsCentrally
Wiederherstellungsbezogene Eigenschaften
UseMauiEssentials
ValidateExecutableReferencesMatchSelfContained

AssetTargetFallback

Mit der Eigenschaft können Sie zusätzliche kompatible Frameworkversionen für Projektverweise und NuGet-Pakete angeben. Wenn Sie z. B. mit eine Paketabhängigkeit angeben, aber das entsprechende Paket keine Assets enthält, die mit dem Ihres Projekts kompatibel sind, kommt die Eigenschaft ins Spiel. Die Kompatibilität des referenzierten Pakets wird erneut anhand jedes Zielframeworks überprüft, das in angegeben ist. Diese Eigenschaft ersetzt die veraltete Eigenschaft .

Sie können die Eigenschaft auf eine oder mehrere Zielframeworkversionen festlegen.

<PropertyGroup>
  <AssetTargetFallback>net461</AssetTargetFallback>
</PropertyGroup>

DisableImplicitFrameworkReferences

Die eigenschaft DisableImplicitFrameworkReferences steuert implizite FrameworkReference elemente, wenn sie auf .NET Core 3.0 und höher ausgerichtet sind. Bei der Zielbestimmung für .NET Core 2.1 oder .NET Standard 2.0 und früheren Versionen steuert sie implizite PackageReference Elemente in Paketen in einem Metapaket. (Ein Metapaket ist ein frameworkbasiertes Paket, das nur aus Abhängigkeiten von anderen Paketen besteht.) Diese Eigenschaft steuert auch implizite Verweise wie System und System.Core bei der Ausrichtung auf .NET Framework.

Legen Sie diese Eigenschaft auf fest, um implizite FrameworkReference- oder PackageReference-Elemente zu deaktivieren. Wenn Sie diese Eigenschaft auf festlegen, können Sie auf Framework- oder Paketebene je nach Bedarf explizite Verweise hinzufügen.

<PropertyGroup>
  <DisableImplicitFrameworkReferences>true</DisableImplicitFrameworkReferences>
</PropertyGroup>

DisableTransitiveFrameworkReferenceDownloads

Legen Sie die -Eigenschaft auf fest, um das Herunterladen zusätzlicher Runtime- und Zielversionspakete zu vermeiden, auf die ihr Projekt nicht direkt verweist.

<PropertyGroup>
  <DisableTransitiveFrameworkReferenceDownloads>true</DisableTransitiveFrameworkReferenceDownloads>
</PropertyGroup>

DisableTransitiveProjectReferences

Die -Eigenschaft steuert implizite Projektverweise. Legen Sie diese Eigenschaft auf fest, um implizite -Elemente zu deaktivieren. Das Deaktivieren impliziter Projektverweise führt zu einem nicht transitiven Verhalten, das dem Legacyprojektsystem ähnelt.

Wenn diese Eigenschaft ist, hat sie einen ähnlichen Effekt wie das Festlegen von für alle Abhängigkeiten des Projekts, von dem die Abhängigkeit besteht.

Wenn Sie diese Eigenschaft auf festlegen, können Sie explizite Verweise auf nur die von Ihnen benötigten Projekte hinzufügen.

<PropertyGroup>
  <DisableTransitiveProjectReferences>true</DisableTransitiveProjectReferences>
</PropertyGroup>

ManagePackageVersionsCentrally

Die eigenschaft ManagePackageVersionsCentrally wurde in .NET 7 eingeführt. Indem Sie sie in einer -Datei im Stammverzeichnis Ihres Repositorys auf festlegen, können Sie allgemeine Abhängigkeiten in Ihren Projekten von einem Ort aus verwalten. Fügen Sie Versionen für allgemeine Paketabhängigkeiten mithilfe von -Elementen in der Datei Directory.Packages.props hinzu. Anschließend können Sie in den einzelnen Projektdateien -Attribute aus allen -Elementen auslassen, die auf zentral verwaltete Pakete verweisen.

Beispieldatei Directory.Packages.props:

<PropertyGroup>
  <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
</PropertyGroup>
...
<ItemGroup>
  <PackageVersion Include="Microsoft.Extensions.Configuration" Version="9.0.0" />
</ItemGroup>

Einzelne Projektdatei:

<ItemGroup>
  <PackageReference Include="Microsoft.Extensions.Configuration" />
</ItemGroup>

Weitere Informationen finden Sie unter Zentrale Paketverwaltung (CPM).

Durch das Wiederherstellen eines referenzierten Pakets werden alle seine direkten Abhängigkeiten sowie alle Abhängigkeiten dieser Abhängigkeiten installiert. Sie können die Paketwiederherstellung anpassen, indem Sie Eigenschaften wie und angeben. Weitere Informationen zu diesen und anderen Eigenschaften finden Sie unter Wiederherstellungsziel.

<PropertyGroup>
  <RestoreIgnoreFailedSource>true</RestoreIgnoreFailedSource>
</PropertyGroup>

UseMauiEssentials

Legen Sie die -Eigenschaft auf fest, um einen expliziten Verweis auf ein Projekt oder Paket zu deklarieren, das von MAUI Essentials abhängig ist. Diese Einstellung stellt sicher, dass Ihr Projekt den richtigen bekannten Frameworkverweis für MAUI Essentials abruft. Wenn Ihr Projekt auf ein Projekt verweist, das MAUI Essentials verwendet, Sie diese Eigenschaft aber nicht auf festlegen, wird möglicherweise die Buildwarnung angezeigt.

<PropertyGroup>
  <UseMauiEssentials>true</UseMauiEssentials>
</PropertyGroup>

ValidateExecutableReferencesMatchSelfContained

Mit der Eigenschaft können Fehler im Zusammenhang mit Verweisen in einem ausführbaren Projekt behoben werden. Wenn .NET erkennt, dass ein eigenständiges ausführbares Projekt auf ein frameworkabhängiges ausführbares Projekt verweist oder umgekehrt, generiert es Fehler NETSDK1150 bzw. NETSDK1151. Um diese Fehler im Fall eines beabsichtigten Verweises zu vermeiden, legen Sie die Eigenschaft auf fest.

<PropertyGroup>
  <ValidateExecutableReferencesMatchSelfContained>false</ValidateExecutableReferencesMatchSelfContained>
</PropertyGroup>

WindowsSdkPackageVersion

Die eigenschaft WindowsSdkPackageVersion kann verwendet werden, um die Version des Windows SDK-Zielpakets außer Kraft zu setzen. Diese Eigenschaft wurde in .NET 5 eingeführt und ersetzt die Verwendung des elements FrameworkReference zu diesem Zweck.

<PropertyGroup>
  <WindowsSdkPackageVersion>10.0.19041.18</WindowsSdkPackageVersion>
</PropertyGroup>

Note

Es wird nicht empfohlen, die Windows SDK-Version außer Kraft zu setzen, da die Windows SDK-Zielpakete im .NET 5+ SDK enthalten sind. Aktualisieren Sie stattdessen Ihre Version des .NET SDK, um auf das neueste Windows SDK-Paket zu verweisen. Diese Eigenschaft sollte nur in seltenen Fällen verwendet werden, z. B. bei der Verwendung von Vorschaupaketen oder beim Überschreiben der C#/WinRT-Version.

Die folgenden Eigenschaften werden verwendet, um Apps mit dem Befehl zu starten:

RunArguments
RunWorkingDirectory

RunArguments

Die Eigenschaft definiert die Argumente, die beim Ausführen an die App übergeben werden.

<PropertyGroup>
  <RunArguments>-mode dryrun</RunArguments>
</PropertyGroup>

Tip

Sie können zusätzliche Argumente angeben, die an die App übergeben werden sollen, indem Sie die Option für verwenden.

RunWorkingDirectory

Die Eigenschaft definiert das Arbeitsverzeichnis für den Anwendungsprozess, in dem diese gestartet werden soll. Dies kann ein absoluter Pfad oder ein Pfad sein, der relativ zum Projektverzeichnis ist. Wenn Sie kein Verzeichnis angeben, wird als Arbeitsverzeichnis verwendet.

<PropertyGroup>
  <RunWorkingDirectory>c:\temp</RunWorkingDirectory>
</PropertyGroup>

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

SdkAnalysisLevel

SdkAnalysisLevel

In .NET 9 eingeführt, kann die eigenschaft SdkAnalysisLevel verwendet werden, um zu konfigurieren, wie trict SDK tooling ist. Es hilft Ihnen, SDK-Warnstufen in Situationen zu verwalten, in denen Sie SDKs möglicherweise nicht über global.json oder andere Mittel anheften können. Sie können diese Eigenschaft verwenden, um einem neueren SDK mitzuteilen, dass es sich um ein älteres SDK im Hinblick auf ein bestimmtes Tool oder Feature handelt, ohne das ältere SDK installieren zu müssen.

Die zulässigen Werte dieser Eigenschaft sind SDK-Featurebänder, z. B. 8.0.100 und 8.0.400. Der Standardwert ist das SDK-Featureband des ausgeführten SDK. For example, for SDK 9.0.102, the value to use is 9.0.100. (Informationen zur Versionsverwaltung des .NET SDK finden Sie unter How .NET versioned.)

<PropertyGroup>
  <SdkAnalysisLevel>8.0.400</SdkAnalysisLevel>
</PropertyGroup>

Weitere Informationen finden Sie unter SDK Analysis Level Property and Usage.

In der folgenden Tabelle sind die von der Diagnose und verhaltensweisen betroffenen Verhaltensweisen zusammengefasst.

SDKAnalysisLevel	Description	Aktualisiertes Verhalten
9.0.100	Diagnose von HTTP-Quellen wiederherstellen	Gibt den NU1302-Fehler anstelle der NU1803-Warnung aus.
10.0.100	"Wiederherstellen"-Paketschnitt	PrunePackageReference ist standardmäßig für Projekte aktiviert, die auf .NET 8+ oder .NET Standard 2,0+ abzielen.
10.0.100	Resolver "Wiederherstellen" mit Sperrdateien	Verwendet verbesserten, .NET 9 Abhängigkeitsdiagramm-Resolver anstelle des Legacy-Abhängigkeitsdiagrammlösers (.NET 8 SDK und früher).
10.0.100	Verhalten "Wiederherstellen" für PackageReference ohne Version	Gibt DEN NU1015-Fehler anstelle der NU1603-Warnung aus.

Note

Das Vom Wert aktivierte Verhalten läuft nach drei Hauptversionen ab (läuft ab). Beispielsweise berücksichtigt Version 11.0.100 nur Werte bis 8.0.100. In Version 12.0.100 würden Features, die in früheren Versionen durch Festlegen eines Werts von 8.0.100 deaktiviert werden könnten, nicht mehr deaktiviert.

Microsoft.Testing.Platform–bezogene Eigenschaften

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

IsTestingPlatformApplication
Enable[NugetPackageNameWithoutDots]
EnableAspireTesting
EnableMSTestRunner
EnableNUnitRunner
EnablePlaywright
GenerateTestingPlatformConfigurationFile
GenerateTestingPlatformEntryPoint
TestingExtensionsProfile
TestingPlatformCaptureOutput
TestingPlatformCommandLineArguments
TestingPlatformDotnetTestSupport
TestingPlatformShowTestsFailure
UseMicrosoftTestingPlatformRunner

IsTestingPlatformApplication

Wenn Ihr Projekt auf das Microsoft.Testing.Platform.MSBuild-Paket verweist, führt die Einstellung auf (was auch der Standardwert ist, falls nicht angegeben) folgendes aus:

Generiert den Einstiegspunkt zum Testprojekt.
Generiert die Konfigurationsdatei.
Erkennt die Erweiterungen.

Durch Festlegen der Eigenschaft wird die transitive Abhängigkeit zum Paket deaktiviert. Eine transitive Abhängigkeit ist, wenn ein Projekt, das auf ein anderes Projekt verweist, das auf ein bestimmtes Paket verweist, sich so verhält, als ob es auf das Paket verweist. In der Regel legen Sie diese Eigenschaft in einem Nichttestprojekt fest , das auf ein Testprojekt verweist. Weitere Informationen finden Sie unter Fehler CS8892.

Wenn Ihr Testprojekt auf MSTest, NUnit oder xUnit verweist, wird diese Eigenschaft auf denselben Wert wie EnableMSTestRunner, EnableNUnitRunner oder (für xUnit) festgelegt.

Enable[NugetPackageNameWithoutDots]

Verwenden Sie eine Eigenschaft mit dem Muster , um Microsoft.Testing.Platform-Erweiterungen zu aktivieren oder zu deaktivieren.

Um z. B. die Absturzabbilderweiterung (NuGet-Paket "Microsoft.Testing.Extensions.CrashDump") zu aktivieren, legen Sie die Option auf . fest.

Weitere Informationen finden Sie unter Aktivieren oder Deaktivieren von Erweiterungen.

EnableAspireTesting

Wenn Sie das MSTest-Projekt-SDK verwenden, können Sie die Eigenschaft verwenden, um alle Abhängigkeiten und Standarddirektiven einzubringen, die Sie zum Testen mit und verwenden müssen. Diese Eigenschaft ist in MSTest 3.4 und höheren Versionen verfügbar.

Weitere Informationen finden Sie unter "Test with Aspire".

EnablePlaywright

Weitere Informationen finden Sie unter Playwright.

EnableMSTestRunner

Die Eigenschaft aktiviert oder deaktiviert die Verwendung von Microsoft.Testing.Platform (MTP), einer einfachen und tragbaren Alternative zu VSTest. Diese Eigenschaft ist in MSTest 3.2 und höheren Versionen verfügbar.

Note

Wenn Ihr Projekt das MSTest SDK angibt, müssen Sie diese Eigenschaft nicht festlegen. Sie wird automatisch festgelegt.

EnableNUnitRunner

Die Eigenschaft aktiviert oder deaktiviert die Verwendung des NUnit-Runners. Der NUnit runner ist eine leichte und tragbare Alternative zu VSTest. Diese Eigenschaft ist in NUnit3TestAdapter in Version 5.0 und höher verfügbar.

UseMicrosoftTestingPlatformRunner

Die Eigenschaft aktiviert oder deaktiviert die Verwendung von Microsoft.Testing.Platform runner in xUnit.v3-Testprojekten .

GenerateTestingPlatformEntryPoint

Wenn Sie die eigenschaft auf festlegen, wird die automatische Generierung des Programmeinstiegspunkts in Testprojekten deaktiviert, die Microsoft.Testing.Platformverwenden. Sie können diese Eigenschaft festlegen, wenn Sie manuell einen Einstiegspunkt definieren oder wenn Sie auf ein Testprojekt aus einer ausführbaren Datei verweisen, die ebenfalls einen Einstiegspunkt aufweist.

Weitere Informationen finden Sie unter Fehler CS8892.

Verwenden Sie die Eigenschaft, um die Generierung des Einstiegspunkts in einem VSTest-Projekt zu steuern.

GenerateTestingPlatformConfigurationFile

Die Eigenschaft ist nur verfügbar, wenn IsTestingPlatformApplication ist . Sie wird verwendet, um die Kopie und Die Umbenennung der Konfigurationsdatei im Ausgabeordner zuzulassen.

TestingPlatformCaptureOutput

Die Eigenschaft steuert, ob alle Konsolenausgabe, die eine ausführbare Testdatei schreibt, erfasst und beim Ausführen von Tests vom Benutzer ausgeblendet wird. Standardmäßig ist die Konsolenausgabe ausgeblendet. Diese Ausgabe enthält die Banner-, Versionsinformationen und formatierten Testinformationen. Legen Sie diese Eigenschaft fest, um diese Informationen zusammen mit der MSBuild-Ausgabe anzuzeigen.

Weitere Informationen finden Sie unter Anzeigen der vollständigen Plattformausgabe.

TestingPlatformCommandLineArguments

Mit der Eigenschaft können Sie Befehlszeilenargumente für die Test-App angeben, wenn Sie Tests ausführen . Der folgende Projektdateiausschnitt zeigt ein Beispiel.

<PropertyGroup>
  ...
  <TestingPlatformCommandLineArguments>--minimum-expected-tests 10</TestingPlatformCommandLineArguments>
</PropertyGroup>

TestingPlatformDotnetTestSupport

Die Eigenschaft ermöglicht das Testen von Microsoft.Testing.Platform-Apps bei Verwendung des VSTest-Modus von .

Note

Rufen Sie keine Lösung mit VSTest- und Microsoft.Testing.Platform-Projekten auf , da dieses Szenario nicht unterstützt wird.

Weitere Informationen finden Sie unter "Testen mit dotnet test".

TestingPlatformShowTestsFailure

Mit der Eigenschaft können Sie steuern, ob ein einzelner Fehler oder alle Fehler in einem fehlgeschlagenen Test gemeldet werden, wenn Sie Tests ausführen. Standardmäßig werden Testfehler in einer LOG-Datei zusammengefasst, und pro Testprojekt wird ein einzelner Fehler an MSBuild gemeldet. Um Fehler pro fehlgeschlagenen Test anzuzeigen, legen Sie diese Eigenschaft in der Projektdatei fest .

TestingExtensionsProfile

Wenn Sie das MSTest-Projekt-SDK verwenden, können Sie mit der Eigenschaft ein zu verwendenes Profil auswählen. In der folgenden Tabelle sind die zulässigen Werte aufgeführt.

Value	Description
`Default`	Aktiviert die empfohlenen Erweiterungen für diese Version von MSTest.SDK.
`None`	Es sind keine Erweiterungen aktiviert.
`AllMicrosoft`	Aktivieren Sie alle von Microsoft gelieferten Erweiterungen (einschließlich Erweiterungen mit einer restriktiven Lizenz).

Weitere Informationen finden Sie unter Microsoft.Testing.Platform-Profil.

VSTest-bezogene Eigenschaften

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

IsTestProject
UseVSTest

IsTestProject

Die eigenschaft IsTestProject wird vom Microsoft.NET auf true festgelegt. Test.Sdk NuGet-Paket. Es bedeutet, ob es sich bei einem Projekt um ein VSTest-Testprojekt handelt, damit es von diesem erkannt wird.

Note

Wenn Ihr Projekt das MSTest SDK angibt, müssen Sie diese Eigenschaft nicht festlegen, da MSTest.Sdk auf microsoft.NET verweist. Test.Sdk NuGet-Paket.

UseVSTest

Legen Sie die -Eigenschaft auf fest, um von Microsoft.Testing.Platform zum VSTest Runner zu wechseln, wenn Sie das MSTest Project SDKverwenden.

MSTest-bezogene Eigenschaften

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

MSTestAnalysisMode

MSTestAnalysisMode

Diese Eigenschaft entscheidet, welche Analysegeräte zu welchem Schweregrad aktiviert sind. Weitere Informationen finden Sie unter MSTest-Codeanalyse.

Die folgenden MSBuild-Eigenschaften sind in diesem Abschnitt dokumentiert:

AppHostDotNetSearch
AppHostRelativeDotNet
EnableComHosting
EnableDynamicLoading

AppHostDotNetSearch

Die eigenschaft AppHostDotNetSearch konfiguriert, wie die systemeigene ausführbare Datei, die für eine Anwendung erstellt wurde, nach einer .NET Installation sucht. Diese Eigenschaft wirkt sich nur auf die ausführbare Datei aus, die bei der Veröffentlichung erstellt wurde, nicht auf den Build.

<PropertyGroup>
  <AppHostDotNetSearch>Global</AppHostDotNetSearch>
</PropertyGroup>

In der folgenden Tabelle sind gültige Werte aufgeführt. Sie können mehrere Werte angeben, getrennt durch Semikolons.

Value	Meaning
`AppLocal`	Ordner der ausführbaren App-Datei
`AppRelative`	Pfad relativ zur ausführbaren App,wie von AppHostRelativeDotNet angegeben
`EnvironmentVariable`	Wert von Umgebungsvariablen
`Global`	Registrierte und standardmäßige globale Installationsspeicherorte

Diese Eigenschaft wurde in .NET 9 eingeführt.

AppHostRelativeDotNet

Die eigenschaft AppHostRelativeDotNet ermöglicht die Angabe eines relativen Pfads für die ausführbare App, um nach der .NET Installation zu suchen, wenn sie konfiguriert ist. Das Festlegen der Eigenschaft impliziert, dass das heißt . Diese Eigenschaft wirkt sich nur auf die ausführbare Datei aus, die bei der Veröffentlichung erstellt wurde, nicht auf den Build.

<PropertyGroup>
  <AppHostRelativeDotNet>./relative/path/to/runtime</AppHostRelativeDotNet>
</PropertyGroup>

Diese Eigenschaft wurde in .NET 9 eingeführt.

EnableComHosting

Die -Eigenschaft gibt an, dass eine Assembly einen COM-Server bereitstellt. Wenn die -Eigenschaft auf festgelegt wird, bedeutet dies auch, dass EnableDynamicLoading ist.

<PropertyGroup>
  <EnableComHosting>True</EnableComHosting>
</PropertyGroup>

Weitere Informationen finden Sie unter Expose .NET Komponenten zu COM.

EnableDynamicLoading

Die -Eigenschaft gibt an, dass eine Assembly eine dynamisch geladene Komponente ist. Die Komponente kann eine COM-Bibliothek oder eine Nicht-COM-Bibliothek sein, die von einem nativen Host oder als PlugIn verwendet werden kann. Wenn diese Eigenschaft auf festgelegt wird, hat diese die folgenden Auswirkungen:

Eine .runtimeconfig.json-Datei wird generiert.
RollForward wird auf festgelegt.
NuGet-Verweise werden lokal kopiert.

<PropertyGroup>
  <EnableDynamicLoading>true</EnableDynamicLoading>
</PropertyGroup>

Eigenschaften der generierten Datei

Die folgenden Eigenschaften betreffen Code in generierten Dateien:

DisableImplicitNamespaceImports
ImplicitUsings

DisableImplicitNamespaceImports

Die eigenschaft DisableImplicitNamespaceImports kann verwendet werden, um implizite Namespaceimporte in Visual Basic Projekten zu deaktivieren, die auf .NET 6 oder höher ausgerichtet sind. Implizite Namespaces sind die Standardnamespaces, die global in einem Visual Basic Projekt importiert werden. Legen Sie diese Eigenschaft auf fest, um implizite Namespaceimporte zu deaktivieren.

<PropertyGroup>
  <DisableImplicitNamespaceImports>true</DisableImplicitNamespaceImports>
</PropertyGroup>

ImplicitUsings

Die eigenschaft ImplicitUsings kann verwendet werden, um implizite global usingdirektiven in C#-Projekten zu aktivieren und zu deaktivieren, die auf .NET 6 oder eine höhere Version und C# 10 oder eine höhere Version abzielen. Wenn das Feature aktiviert ist, fügt das .NET SDK global using-Direktiven für eine Reihe von Standardnamespaces basierend auf dem Projekt-SDK-Typ hinzu. Legen Sie diese Eigenschaft auf oder fest, um implizite -Anweisungen zu aktivieren. Um implizite -Anweisungen zu deaktivieren, entfernen Sie die Eigenschaft, oder legen Sie sie auf oder fest.

<PropertyGroup>
  <ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>

Note

Die Vorlagen für neue C#-Projekte, die auf .NET 6 oder höher abzielen, haben standardmäßig ImplicitUsings auf enable festgelegt.

Um eine explizite -Anweisung definieren, fügen Sie ein Using-Element hinzu.

Items

MSBuild-Elemente sind Eingaben in das Buildsystem. Elemente werden ihrem Typ (d. h. dem Elementnamen) entsprechend angegeben. Beispielsweise sind und zwei gängige Elementtypen. Die folgenden zusätzlichen Elementtypen werden vom .NET SDK zur Verfügung gestellt:

AssemblyMetadata
InternalsVisibleTo
PackageReference
TrimmerRootAssembly
Using

Sie können jedes Standardelementattribut (z. B. und ) für diese Elemente verwenden. Verwenden Sie , um ein neues Element hinzuzufügen, und , um ein vorhandenes Element zu ändern. Beispielsweise wird Update häufig verwendet, um ein Element zu ändern, das implizit vom .NET SDK hinzugefügt wurde.

AssemblyMetadata

Das -Element gibt ein -Assemblyattribut mit einem Schlüssel-Wert-Paar an. Die -Metadaten werden zum Schlüssel, und die -Metadaten werden zum Wert.

<ItemGroup>
  <AssemblyMetadata Include="Serviceable" Value="True" />
</ItemGroup>

InternalsVisibleTo

Das -Element generiert ein -Assemblyattribut für die angegebene Friend-Assembly.

<ItemGroup>
  <InternalsVisibleTo Include="MyProject.Tests" />
</ItemGroup>

Wenn die Friend-Assembly signiert ist, können Sie optionale -Metadaten angeben, um den vollständigen öffentlichen Schlüssel anzugeben. Wenn Sie keine -Metadaten angeben und ein verfügbar ist, wird dieser Schlüssel verwendet. Andernfalls wird dem Attribut kein öffentlicher Schlüssel hinzugefügt.

FrameworkReference

Das element FrameworkReference definiert einen Verweis auf ein .NET freigegebenes Framework.

Das -Attribut gibt die Framework-ID an.

Der Codeausschnitt für die Projektdatei im folgenden Beispiel verweist auf das freigegebene Framework Microsoft.AspNetCore.App.

<ItemGroup>
  <FrameworkReference Include="Microsoft.AspNetCore.App" />
</ItemGroup>

PackageReference

Das -Element definiert einen Verweis auf ein NuGet-Paket.

Das -Attribut gibt die Paket-ID an. Das -Attribut gibt die Version oder den Versionsbereich an. Informationen, wie Sie eine Mindestversion, Maximalversion, einen Versionsbereich oder eine exakte Versionsübereinstimmung angeben, finden Sie unter Versionsbereiche.

Der Codeausschnitt für die Projektdatei im folgenden Beispiel verweist auf das Paket System.Runtime.

<ItemGroup>
  <PackageReference Include="System.Runtime" Version="4.3.0" />
</ItemGroup>

Sie können Abhängigkeitsobjekte auch mit Metadaten wie steuern.

<ItemGroup>
  <PackageReference Include="Contoso.Utility.UsefulStuff" Version="3.6.0">
    <PrivateAssets>all</PrivateAssets>
  </PackageReference>
</ItemGroup>

Weitere Informationen finden Sie unter Paketverweis in Projektdateien.

TrimmerRootAssembly

Mit dem -Element können Sie eine Assembly aus der Kürzung ausschließen. Die Kürzung ist der Prozess, bei dem nicht verwendete Teile der Runtime aus einer gepackten Anwendung entfernt werden. In einigen Fällen können die erforderlichen Verweise durch eine Kürzung fälschlicherweise entfernt werden.

Der folgende XML-Code schließt die -Assembly aus der Kürzung aus.

<ItemGroup>
  <TrimmerRootAssembly Include="System.Security" />
</ItemGroup>

Weitere Informationen finden Sie unter Kürzungsoptionen.

Using

Mit dem -Element können Sie einen Namespace global in Ihr C#-Projekt einbinden, sodass Sie keine -Anweisung für den Namespace am Anfang Ihrer Quelldateien hinzufügen müssen. Dieses Element ähnelt dem Import Element, das für denselben Zweck in Visual Basic Projekten verwendet werden kann. Diese Eigenschaft ist ab .NET 6 verfügbar.

<ItemGroup>
  <Using Include="My.Awesome.Namespace" />
</ItemGroup>

Sie können das -Element auch verwenden, um globale - und -Anweisungen zu definieren.

<ItemGroup>
  <Using Include="My.Awesome.Namespace" Alias="Awesome" />
</ItemGroup>

Beispiel:

gibt aus
gibt aus

Weitere Informationen finden Sie unter -Aliasanweisungen und -Anweisungen.

Elementmetadaten

Zusätzlich zu den standardmäßigen MSBuild-Elementattributen werden die folgenden Elementmetadatentags vom .NET SDK zur Verfügung gestellt:

CopyToPublishDirectory
LinkBase

CopyToPublishDirectory

Die -Metadaten in einem MSBuild-Element steuern, wann das Element in das Veröffentlichungsverzeichnis kopiert wird. In der folgenden Tabelle sind die zulässigen Werte aufgeführt.

Value	Description
`PreserveNewest`	Kopiert das Element nur, wenn es am Quellspeicherort geändert wurde.
`IfDifferent`	Kopiert das Element nur, wenn es sich entweder im Quell- oder Zielspeicherort geändert hat. Diese Einstellung ist hilfreich für Situationen, in denen Sie Änderungen zurücksetzen müssen, die nach der Veröffentlichung auftreten.
`Always`	Kopiert das Element immer.
`Never`	Kopiert das Element nie.

Aus Leistungssicht ist zu bevorzugen, da so inkrementelle Builds ermöglicht werden. Vermeiden Sie die Verwendung von und verwenden Sie stattdessen , wodurch keine E/A-Schreibvorgänge ohne Wirkung vermieden werden.

<ItemGroup>
  <None Update="appsettings.Development.json" CopyToOutputDirectory="PreserveNewest" CopyToPublishDirectory="PreserveNewest" />
</ItemGroup>

LinkBase

Wenn ein Element sich außerhalb des Projektverzeichnisses und dessen Unterverzeichnissen befindet, verwendet das Veröffentlichungsziel die Link-Metadaten des Elements, um zu bestimmen, wohin es kopiert werden soll. Link bestimmt auch, wie Elemente außerhalb der Projektstruktur im Projektmappen-Explorer Fenster Visual Studio angezeigt werden.

Wenn für ein Element nicht angegeben ist, das sich außerhalb der Projektstruktur befindet, wird standardmäßig der Wert festgelegt. Mit können Sie einen sinnvollen Basisordner für Elemente außerhalb der Projektstruktur angeben. Die Ordnerhierarchie des Basisordners wird mit beibehalten. Wenn nicht angegeben wird, wird das Element im -Pfad weggelassen.

<ItemGroup>
  <Content Include="..\Extras\**\*.cs" LinkBase="Shared"/>
</ItemGroup>

Die folgende Abbildung zeigt, wie eine Datei, die über das vorherige Element enthalten ist, Include Glob in Projektmappen-Explorer angezeigt wird.

Projektmappen-Explorer mit linkBase metadata.

Siehe auch

MSBuild-Schemareferenz
Gemeinsame MSBuild-Eigenschaften
MSBuild-Eigenschaften für NuGet-Ziel „pack“
MSBuild-Eigenschaften für NuGet-Ziel „restore“
Anpassen eines Builds

Feedback

War diese Seite hilfreich?

Last updated on 2026-03-06

Freigeben über

MSBuild-Referenz für .NET SDK-Projekte

Eigenschaften der Assemblyüberprüfung

ApiCompatStrictMode

ApiCompatValidateAssemblies

Eigenschaften von Assemblyattributen

GenerateAssemblyInfo

GeneratedAssemblyInfoFile

IncludeSourceRevisionInInformationalVersion

SourceRevisionId

Framework-Eigenschaften

TargetFramework

TargetFrameworks

NetStandardImplicitPackageVersion

Paketeigenschaften

Beschreibende Eigenschaften

PackRelease

Paketüberprüfungseigenschaften

ApiCompatEnableRuleAttributesMustMatch

ApiCompatEnableRuleCannotChangeParameterName

ApiCompatExcludeAttributesFile

ApiCompatGenerateSuppressionFile

ApiCompatPermitUnnecessarySuppressions

ApiCompatPreserveUnnecessarySuppressions

ApiCompatRespectInternals

ApiCompatSuppressionFile

ApiCompatSuppressionOutputFile

EnablePackageValidation

EnableStrictModeForBaselineValidation

EnableStrictModeForCompatibleFrameworksInPackage

EnableStrictModeForCompatibleTfms

NoWarn

PackageValidationBaselineFrameworkToIgnore

PackageValidationBaselineName

PackageValidationBaselineVersion

PackageValidationReferencePath

RoslynAssembliesPath

Veröffentlichungsbezogene Eigenschaften

AppendTargetFrameworkToOutputPath

AppendRuntimeIdentifierToOutputPath

CopyLocalLockFileAssemblies

ErrorOnDuplicatePublishOutputFiles

GenerateRuntimeConfigDevFile

GenerateRuntimeConfigurationFiles

GenerateSatelliteAssembliesForCore

IsPublishable

PreserveCompilationContext

PreserveCompilationReferences

ProduceReferenceAssemblyInOutDir

PublishDocumentationFile

PublishDocumentationFiles

PublishReferencesDocumentationFiles

PublishReferencesSymbols

PublishRelease

PublishSelfContained

RollForward

RuntimeFrameworkVersion

RuntimeIdentifier

RuntimeIdentifiers

SatelliteResourceLanguages

SelfContained

UseAppHost

Trim-related properties

Buildbezogene Eigenschaften

ContinuousIntegrationBuild

CopyDebugSymbolFilesFromPackages

CopyDocumentationFilesFromPackages

DisableImplicitFrameworkDefines

DocumentationFile

EmbeddedResourceUseDependentUponConvention

EnablePreviewFeatures

EnableWindowsTargeting

GenerateDocumentationFile

GenerateRequiresPreviewFeaturesAttribute

OptimizeImplicitlyTriggeredBuild

DisableRuntimeMarshalling

BuildWithNetFrameworkHostedCompiler

RoslynCompilerType

Standardeigenschaften für den Elementeinschluss

DefaultItemExcludes