Allgemeine MSBuild-Projekteigenschaften
In der folgenden Tabelle sind häufig verwendete Eigenschaften aufgeführt, die in den Visual Studio-Projektdateien definiert oder in .targets Dateien enthalten sind, die MSBuild bereitstellt.
Project-Dateien in Visual Studio (.csproj, .vbproj, .vcxprojund andere) enthalten MSBuild-XML-Code, der ausgeführt wird, wenn Sie ein Projekt mithilfe der IDE erstellen. Projekte importieren in der Regel einen oder mehrere .targets Dateien, um ihren Buildprozess zu definieren. Weitere Informationen finden Sie unter MSBuild.targets files.
Beachten Sie beim Festlegen von Eigenschaftswerten, dass allgemeine Eigenschaften möglicherweise festgelegt, zurückgesetzt oder in einer Reihe importierter Dateien verwendet werden. Daher ist es wichtig, wo Sie eine Eigenschaft in Ihrer Projektdatei, in Directory.Build.propsoder in einer anderen importierten Datei festlegen. Wenn Sie eine Eigenschaft an einer beliebigen Stelle festlegen und nicht das erwartete Ergebnis erhalten, überlegen Sie, wo und wie die Eigenschaft in allen von Ihrem Projekt importierten Dateien geändert oder verwendet wird, einschließlich Importen, die implizit hinzugefügt werden, wenn Sie das attribut Sdk verwenden. Siehe Wählen Sie zwischen dem Hinzufügen von Eigenschaften zu einer PROPS- oder ZIEL-Datei. Die Vorverarbeitung kann ihnen dabei helfen (siehe die Befehlszeilenoption /preprocess oder /pp unter MSBuild-Befehlszeilenreferenz).
Liste der allgemeinen Eigenschaften und Parameter
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| AdditionalLibPaths | .NETTO | Gibt zusätzliche Ordner an, in denen Compiler nach Referenzassemblys suchen sollen. |
| AddModules | .NETTO | Bewirkt, dass der Compiler alle Typinformationen aus den angegebenen Dateien für das Projekt verfügbar macht, das Sie kompilieren. Diese Eigenschaft entspricht dem /addModules Compilerschalter. |
| ALToolPath | .NETTO | Der Pfad zu AL.exe. Diese Eigenschaft setzt die aktuelle Version von AL.exe außer Kraft, um die Verwendung einer anderen Version zu ermöglichen. |
| ApplicationIcon | .NETTO | Die .ico Symboldatei, die zum Einbetten als Win32-Symbol an den Compiler übergeben werden soll. Die Eigenschaft entspricht dem /win32icon Compilerschalter. |
| ApplicationManifest | Alle | Gibt den Pfad der Datei an, die zum Generieren externer Benutzerkontensteuerungs-Manifestinformationen (User Account Control, UAC) verwendet wird. Gilt nur für Visual Studio-Projekte für Windows Vista. In den meisten Fällen ist das Manifest eingebettet. Wenn Sie jedoch die Kostenlose COM- oder ClickOnce-Bereitstellung "Registration" verwenden, kann das Manifest eine externe Datei sein, die zusammen mit Ihren Anwendungsassemblys installiert ist. Weitere Informationen finden Sie in der NoWin32Manifest-Eigenschaft in diesem Artikel. |
| AssemblyOriginatorKeyFile | .NETTO | Gibt die Datei an, die zum Signieren der Assembly (.snk oder .pfx) verwendet wird und an die ResolveKeySource-Aufgabe übergeben wird, um den tatsächlichen Schlüssel zu generieren, der zum Signieren der Assembly verwendet wird. |
| AssemblySearchPaths | .NETTO | Eine Liste der Speicherorte, die während der Buildzeitverweisassemblyauflösung durchsucht werden sollen. Die Reihenfolge, in der Pfade in dieser Liste angezeigt werden, ist sinnvoll, da zuvor aufgeführte Pfade Vorrang vor späteren Einträgen haben. |
| AssemblyName | .NETTO | Der Name der endgültigen Ausgabeassembly, nachdem das Projekt erstellt wurde. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| BaseAddress | .NETTO | Gibt die Basisadresse der Hauptausgabeassembly an. Diese Eigenschaft entspricht dem /baseaddress Compilerschalter. |
| BaseIntermediateOutputPath | Alle | Der Ordner auf oberster Ebene, in dem alle konfigurationsspezifischen Zwischenausgabeordner erstellt werden. Der Standardwert ist obj\. Der folgende Code ist ein Beispiel: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
| BaseOutputPath | Alle | Gibt den Basispfad für die Ausgabedatei an. Wenn sie festgelegt ist, verwendet MSBuild OutputPath = $(BaseOutputPath)\$(Configuration)\. Beispielsyntax: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
| BuildInParallel | Alle | Ein boolescher Wert, der angibt, ob Projektverweise parallel erstellt oder bereinigt werden, wenn Multi-Proc MSBuild verwendet wird. Der Standardwert ist true, was bedeutet, dass Projekte parallel erstellt werden, wenn das System über mehrere Kerne oder Prozessoren verfügt. |
| BuildProjectReferences | Alle | Ein boolescher Wert, der angibt, ob Projektverweise von MSBuild erstellt werden. Wird automatisch auf false festgelegt, wenn Sie Ihr Projekt in der integrierten Entwicklungsumgebung (Integrated Development Environment, IDE) von Visual Studio erstellen, true andernfalls.
-p:BuildProjectReferences=false können in der Befehlszeile angegeben werden, um zu vermeiden, dass auf die referenzierten Projekte auf dem neuesten Stand sind. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| CleanFile | Alle | Der Name der Datei, die als "sauberer Cache" verwendet wird. Der saubere Cache ist eine Liste der generierten Dateien, die während des Reinigungsvorgangs gelöscht werden sollen. Die Datei wird vom Buildprozess in den Zwischenausgabepfad versetzt. Diese Eigenschaft gibt nur Dateinamen an, die keine Pfadinformationen enthalten. |
| CodePage | .NETTO | Gibt die Codeseite an, die für alle Quellcodedateien in der Kompilierung verwendet werden soll. Diese Eigenschaft entspricht dem /codepage Compilerschalter. |
| CompilerResponseFile | .NETTO | Eine optionale Antwortdatei, die an die Compileraufgaben übergeben werden kann. |
| Konfiguration | Alle | Die Konfiguration, die Sie erstellen, im Allgemeinen Debug oder Release, aber auf Lösungs- und Projektebene konfigurierbar. |
| CscToolPath | C# | Der Pfad von csc.exe, dem C#-Compiler. |
| CustomAfterMicrosoftCommonTargets | Alle | Der Name einer Projektdatei oder Zieldatei, die nach dem Import allgemeiner Ziele automatisch importiert werden soll. |
| CustomBeforeMicrosoftCommonTargets | Alle | Der Name einer Projektdatei oder Zieldatei, die automatisch importiert werden soll, bevor die gemeinsamen Ziele importiert werden. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| DebugSymbols | Alle | Ein boolescher Wert, der angibt, ob Symbole vom Build generiert werden. Durch Festlegen -p:DebugSymbols=false in der Befehlszeile wird die Generierung von Programmdatenbankdateien (.pdb) deaktiviert. |
| DebugType | Alle | Definiert die Ebene der Debuginformationen, die generiert werden sollen. Gültige Werte sind "full", "pdbonly", "portable", "embedded" und "none". |
| DefineConstants | .NETTO | Definiert bedingte Compilerkonstanten. Symbol-/Wertpaare werden durch Semikolons getrennt und mithilfe der sprachabhängigen Syntax angegeben: C#: symbol1; symbol2Visual Basic: symbol1 = value1, symbol2 = value2Die Eigenschaft entspricht dem /define Compilerschalter. |
| DefineDebug | Alle | Ein boolescher Wert, der angibt, ob die DEBUG-Konstante definiert werden soll. |
| DefineTrace | Alle | Ein boolescher Wert, der angibt, ob die TRACE-Konstante definiert werden soll. |
| DelaySign | .NETTO | Ein boolescher Wert, der angibt, ob Sie die Assembly verzögern möchten, anstatt sie vollständig zu signieren. |
| Deterministisch | .NETTO | Ein boolescher Wert, der angibt, ob der Compiler identische Assemblys für identische Eingaben erzeugen soll. Dieser Parameter entspricht dem /deterministic Switch der Compiler. |
| DirectoryBuildPropsPath | Alle | Gibt den Pfad zur datei Directory.Build.props an; wenn definiert, setzt diese Eigenschaft den Standardmäßigen Suchalgorithmus außer Kraft. Siehe Anpassen Des Build-. |
| DirectoryBuildTargetsPath | Alle | Gibt den Pfad zur Directory.Build.targets Datei an; wenn definiert, setzt diese Eigenschaft den Standardmäßigen Suchalgorithmus außer Kraft. Siehe Anpassen Des Build-. |
| DisableFastUpToDateCheck | Alle | Ein boolescher Wert, der nur für Visual Studio gilt. Der Visual Studio-Build-Manager verwendet einen Prozess namens FastUpToDateCheck, um zu bestimmen, ob ein Projekt neu erstellt werden muss, um auf dem neuesten Stand zu sein. Dieser Prozess ist schneller als msBuild zu verwenden, um dies zu ermitteln. Wenn Sie die DisableFastUpToDateCheck-Eigenschaft auf true festlegen, können Sie den Visual Studio-Build-Manager umgehen und erzwingen, dass msBuild verwendet wird, um zu bestimmen, ob das Projekt auf dem neuesten Stand ist. |
| DocumentationFile | .NETTO | Der Name der Datei, die als XML-Dokumentationsdatei generiert wird. Dieser Name enthält nur den Dateinamen und enthält keine Pfadinformationen. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| ErrorReport | .NETTO | Gibt an, wie die Compileraufgabe interne Compilerfehler melden soll. Gültige Werte sind "prompt", "send" oder "none". Diese Eigenschaft entspricht dem /errorreport Compilerschalter. |
| ExcludeDeploymentUrl | .NETTO | Die GenerateDeploymentManifest-Aufgabe fügt dem Bereitstellungsmanifest ein DeploymentProvider-Tag hinzu, wenn die Projektdatei eines der folgenden Elemente enthält: - UpdateUrl - InstallUrl - PublishUrl Mit ExcludeDeploymentUrl können Sie jedoch verhindern, dass das deploymentProvider-Tag dem Bereitstellungsmanifest hinzugefügt wird, auch wenn eine der oben genannten URLs angegeben ist. Fügen Sie dazu der Projektdatei die folgende Eigenschaft hinzu: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Hinweis: ExcludeDeploymentUrl wird in der Visual Studio-IDE nicht verfügbar gemacht und kann nur durch manuelles Bearbeiten der Projektdatei festgelegt werden. Das Festlegen dieser Eigenschaft wirkt sich nicht auf die Veröffentlichung in Visual Studio aus. d. h., das deploymentProvider-Tag wird weiterhin der url hinzugefügt, die von PublishUrl angegeben wurde. |
| FileAlignment | .NETTO | Gibt in Bytes an, wo die Abschnitte der Ausgabedatei ausgerichtet werden sollen. Gültige Werte sind 512, 1024, 2048, 4096, 8192. Diese Eigenschaft entspricht dem /filealignment Compilerschalter. |
| FrameworkPathOverride | Visual Basic | Gibt den Speicherort von mscorlib.dll und microsoft.visualbasic.dllan. Dieser Parameter entspricht dem /sdkpath Switch des vbc.exe Compilers. |
| GenerateDocumentationFile | .NETTO | Ein boolescher Parameter, der angibt, ob die Dokumentation vom Build generiert wird. Wenn true, generiert der Build Dokumentationsinformationen und fügt sie in eine .xml Datei zusammen mit dem Namen der ausführbaren Datei oder Bibliothek, die die Buildaufgabe erstellt hat. |
| GenerateFullPaths | C# | Generieren Sie vollständige Pfade für Dateinamen in der Ausgabe, indem Sie die Option -fullpaths Compiler verwenden. |
| GenerateSerializationAssemblies | .NETTO | Gibt an, ob XML-Serialisierungsassemblys von SGen.exegeneriert werden sollen, die auf ein, automatisch oder deaktiviert festgelegt werden können. Diese Eigenschaft wird nur für Assemblys verwendet, die auf .NET Framework abzielen. Um XML-Serialisierungsassemblys für .NET Standard- oder .NET Core-Assemblys zu generieren, verweisen Sie auf das Microsoft.XmlSerializer.Generator NuGet-Paket. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| ImportDirectoryBuildProps | Alle | Ein boolescher Wert, der angibt, ob eine Directory.Build.props Datei importiert werden soll. Siehe Anpassen Des Build-. |
| ImportDirectoryBuildTargets | Alle | Ein boolescher Wert, der angibt, ob eine Directory.Build.targets Datei importiert werden soll. Siehe Anpassen Des Build-. |
| IntermediateOutputPath | Alle | Der vollständige Zwischenausgabepfad, der von BaseIntermediateOutputPathabgeleitet wurde, wenn kein Pfad angegeben ist. Beispiel: obj\debug\. |
| KeyContainerName | Alle | Der Name des Schlüsselcontainers mit starkem Namen. |
| KeyOriginatorFile | Alle | Der Name der Schlüsseldatei mit starkem Namen. |
| ModuleAssemblyName | .NETTO | Der Name der Assembly, in die das kompilierte Modul integriert werden soll. Die Eigenschaft entspricht dem /moduleassemblyname Compilerschalter. |
| MSBuildProjectExtensionsPath | Alle | Gibt den Pfad an, in dem sich Projekterweiterungen befinden. Standardmäßig verwendet dies denselben Wert wie BaseIntermediateOutputPath. |
| MSBuildTreatWarningsAsErrors | Alle | Ein boolescher Wert, der MSBuild angibt, alle Warnungen als Fehler zu behandeln, es sei denn, sie werden unterdrückt. |
| MSBuildWarningsAsErrors | Alle | Gibt eine Liste von Warnungscodes an, die als Fehler behandelt werden sollen. Trennen Sie mehrere Warnungen durch Semikolons. Wenn Sie die .NET SDK-Eigenschaft WarningsAsErrorsverwenden, verwendet MSBuildWarningsAsErrors standardmäßig den Wert von WarningsAsErrors. |
| MSBuildWarningsAsMessages | Alle | Gibt eine Liste von Warncodes an, die unterdrückt werden sollen, indem sie als Nachrichten mit niedriger Wichtigkeit behandelt werden. Trennen Sie mehrere Warnungen durch Semikolons. Beachten Sie, dass einige von MSBuild ausgegebene Warnungen nicht mithilfe dieser Eigenschaft unterdrückt werden können. um sie zu unterdrücken, verwenden Sie den Befehlszeilenschalter -warnAsMessage. Wenn Sie die .NET SDK-Eigenschaft NoWarnverwenden, verwendet MSBuildWarningsAsMessages standardmäßig den Wert von NoWarn. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| NoLogo | Alle | Ein boolescher Wert, der angibt, ob das Compilerlogo deaktiviert werden soll. Diese Eigenschaft entspricht dem /nologo Compilerschalter. |
| NoStdLib | .NETTO | Ein boolescher Wert, der angibt, ob vermieden werden soll, auf die Standardbibliothek (mscorlib.dll) zu verweisen. Der Standardwert ist false. |
| NoVBRuntimeReference | Visual Basic | Ein boolescher Wert, der angibt, ob die Visual Basic-Laufzeit (Microsoft.VisualBasic.dll) als Verweis in das Projekt eingeschlossen werden soll. |
| NoWarn | .NETTO | Unterdrückt die angegebenen Warnungen. Es muss nur der numerische Teil des Warnungsbezeichners angegeben werden. Mehrere Warnungen werden durch Semikolons getrennt. Dieser Parameter entspricht dem /nowarn Switch der Compiler. |
| NoWin32Manifest | .NETTO | Ein boolescher Wert, der angibt, ob UAC-Manifestinformationen (User Account Control) in die ausführbare Datei der Anwendung eingebettet werden. Gilt nur für Visual Studio-Projekte für Windows Vista. In Projekten, die mithilfe von ClickOnce und Registration-Free COM bereitgestellt werden, wird dieses Element ignoriert.
False (Standardwert) gibt an, dass UAC-Manifestinformationen (User Account Control) in die ausführbare Datei der Anwendung eingebettet werden.
True gibt an, dass UAC-Manifestinformationen nicht eingebettet werden.Diese Eigenschaft gilt nur für Visual Studio-Projekte für Windows Vista. In Projekten, die mithilfe von ClickOnce und Registration-Free COM bereitgestellt werden, wird diese Eigenschaft ignoriert. Sie sollten NoWin32Manifest nur hinzufügen, wenn Visual Studio keine Manifestinformationen in die ausführbare Datei der Anwendung einbetten soll. Dieser Prozess wird als Virtualisierungbezeichnet. Um die Virtualisierung zu verwenden, legen Sie <ApplicationManifest> in Verbindung mit <NoWin32Manifest> wie folgt fest:– Entfernen Sie für Visual Basic-Projekte den knoten <ApplicationManifest>. (In Visual Basic-Projekten wird <NoWin32Manifest> ignoriert, wenn ein <ApplicationManifest> Knoten vorhanden ist.)- Legen Sie für C#-Projekte <ApplicationManifest> auf False und <NoWin32Manifest> auf Truefest. (In C#-Projekten überschreibt <ApplicationManifest><NoWin32Manifest>.)Diese Eigenschaft entspricht dem /nowin32manifest Compilerschalter von vbc.exe. |
| Optimieren | .NETTO | Ein boolescher Wert, der beim Festlegen auf trueCompileroptimierungen ermöglicht. Diese Eigenschaft entspricht dem /optimize Compilerschalter. |
| OptionCompare | VisualBasic | Gibt an, wie Zeichenfolgenvergleiche durchgeführt werden. Gültige Werte sind "binär" oder "Text". Diese Eigenschaft entspricht dem /optioncompare Compilerschalter von vbc.exe. |
| OptionExplicit | Visual Basic | Ein boolescher Wert, der beim Festlegen auf trueexplizite Deklaration von Variablen im Quellcode erfordert. Diese Eigenschaft entspricht dem /optionexplicit Compilerschalter. |
| OptionInfer | Visual Basic | Ein boolescher Wert, der beim Festlegen auf truetypinferieren von Variablen aktiviert wird. Diese Eigenschaft entspricht dem /optioninfer Compilerschalter. |
| OptionStrict | Visual Basic | Ein boolescher Wert, der beim Festlegen auf true, bewirkt, dass die Buildaufgabe strenge Typsemantik erzwingt, um implizite Typkonvertierungen einzuschränken. Diese Eigenschaft entspricht dem /optionstrict Switch des vbc.exe Compilers. |
| OutDir | Alle | Gibt den endgültigen Ausgabespeicherort für das Projekt oder die Projektmappe an. Beim Erstellen einer Lösung kann OutDir verwendet werden, um mehrere Projektausgaben an einem Ort zu sammeln. Darüber hinaus ist OutDir in AssemblySearchPaths enthalten, die zum Auflösen von Verweisen verwendet werden. Beispiel: bin\Debug. |
| OutputPath | Alle | Gibt den Pfad zum Ausgabeverzeichnis relativ zum Projektverzeichnis an, z. B. bin\Debug oder bin\Debug\$(Platform)- in Nicht-AnyCPU-Builds. |
| OutputType | Alle | Gibt das Dateiformat der Ausgabedatei an. Dieser Parameter kann einen der folgenden Werte aufweisen: -Bibliothek. Erstellt eine Codebibliothek. (Standardwert.) - Exe. Erstellt eine Konsolenanwendung. -Modul. Erstellt ein Modul. - Winexe. Erstellt ein Windows-basiertes Programm. Bei C# und Visual Basic entspricht diese Eigenschaft dem Schalter /target. Der Ausgabetyp kann automatisch durch Das Ableiten überschrieben werden. Siehe OutputType auf WinExe für WPF- und WinForms-Appsfestgelegt. Deaktivieren Sie die Ableitung, indem Sie DisableWinExeOutputInference auf truefestlegen. |
| OverwriteReadOnlyFiles | Alle | Ein boolescher Wert, der angibt, ob Der Build das Überschreiben schreibgeschützter Dateien aktivieren oder einen Fehler auslösen soll. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| PathMap | .NETTO | Gibt an, wie physische Pfade dem Vom Compiler ausgegebenen Quellpfadnamen zugeordnet werden. Diese Eigenschaft entspricht dem /pathmap Switch der Compiler. |
| PdbFile | .NETTO | Der Dateiname der .pdb Datei, die Sie ausgibt. Diese Eigenschaft entspricht dem /pdb Switch des csc.exe Compilers. |
| Bahnsteig | Alle | Das Betriebssystem, für das Sie erstellen. Beispiele für .NET Framework-Builds sind "Any CPU", "x86" und "x64". |
| ProcessorArchitecture | .NETTO | Die Prozessorarchitektur, die verwendet wird, wenn Assemblyverweise aufgelöst werden. Gültige Werte sind "msil", "x86", "amd64" oder "ia64". |
| ProduceOnlyReferenceAssembly | .NETTO | Ein boolescher Wert, der den Compiler anweist, nur eine Referenzassembly zu senden, anstatt kompilierten Code. Kann nicht in Verbindung mit ProduceReferenceAssemblyverwendet werden. Diese Eigenschaft entspricht dem /refonly Switch der vbc.exe und csc.exe Compiler. |
| ProduceReferenceAssembly | .NETTO | Ein boolescher Wert, der bei Festlegung auf true die Produktion von Referenzassemblys für die aktuelle Assembly ermöglicht.
Deterministic sollten bei Verwendung dieses Features true werden. Diese Eigenschaft entspricht dem /refout Switch der vbc.exe und csc.exe Compiler. |
| RegisterAssemblyMSBuildArchitecture | Nur Windows | Gibt die Standardarchitektur an, für die die verwaltete DLL registriert ist. Diese Eigenschaft ist nützlich, da COM die Windows-Registrierung verwendet, um die Registrierungen in architekturspezifischen Strukturen zu speichern. In einem Windows-System kann beispielsweise eine verwaltete AnyCPU-Assembly ihre Typen in der 64-Bit-Struktur und/oder in der 32-Bit-Struktur (WoW) registriert haben, und der Build verwendet diese Eigenschaft, um zu bestimmen, welche architekturspezifische Registrierungsstruktur verwendet werden soll. Gültige Werte sind "x86", "x64" und "ARM64". |
| RegisterForCOMInterop | Nur Windows | Gibt an, dass Ihre verwaltete Anwendung ein COM-Objekt (ein COM-Aufrufbares Wrapper) verfügbar macht. Siehe Buildseite - Ausgabeabschnitt. Diese Einstellung betrifft nur den Computer, auf dem das Projekt erstellt wird. Wenn Sie auf anderen Computern bereitstellen, rufen Sie regasm.exe auf, um die Assembly auf dem Zielcomputer zu registrieren. |
| RemoveIntegerChecks | Visual Basic | Ein boolescher Wert, der angibt, ob ganzzahlige Überlauffehlerprüfungen deaktiviert werden sollen. Der Standardwert ist false. Diese Eigenschaft entspricht dem /removeintchecks Switch des vbc.exe Compilers. |
| RootNamespace | Alle | Der Zu verwendende Stammnamespace, wenn Sie eine eingebettete Ressource benennen. Dieser Namespace ist Teil des Namens des eingebetteten Ressourcenmanifests. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| Satellite_AlgorithmId | .NETTO | Die ID des AL.exe Hashingalgorithmus, der beim Erstellen von Satellitenassemblys verwendet werden soll. |
| Satellite_BaseAddress | .NETTO | Die Basisadresse, die verwendet werden soll, wenn kulturspezifische Satellitenassemblys mithilfe des CreateSatelliteAssemblies Ziels erstellt werden. |
| Satellite_CompanyName | .NETTO | Der Firmenname, der während der Satellitenassembly-Erzeugung in AL.exe übergeben werden soll. |
| Satellite_Configuration | .NETTO | Der Konfigurationsname, der während der Satellitenassemblysgenerierung an AL.exe übergeben werden soll. |
| Satellite_Description | .NETTO | Der Beschreibungstext, der während der Satellitenassembly-Generierung in AL.exe übergeben werden soll. |
| Satellite_EvidenceFile | .NETTO | Bettet die angegebene Datei in die Satellitenassembly ein, die den Ressourcennamen "Security.Evidence" aufweist. |
| Satellite_FileVersion | .NETTO | Gibt eine Zeichenfolge für das Feld "Dateiversion" in der Satellitenassembly an. |
| Satellite_Flags | .NETTO | Gibt einen Wert für das Flags-Feld in der Satellitenassembly an. |
| Satellite_GenerateFullPaths | .NETTO | Bewirkt, dass die Buildaufgabe absolute Pfade für alle Dateien verwendet, die in einer Fehlermeldung gemeldet wurden. |
| Satellite_LinkResource | .NETTO | Verknüpft die angegebenen Ressourcendateien mit einer Satellitenassembly. |
| Satellite_MainEntryPoint | .NETTO | Gibt den vollqualifizierten Namen (d. h. class.method) der Methode an, die als Einstiegspunkt verwendet werden soll, wenn ein Modul während der Satellitenassemblysgenerierung in eine ausführbare Datei konvertiert wird. |
| Satellite_ProductName | .NETTO | Gibt eine Zeichenfolge für das Feld "Product" in der Satellitenassembly an. |
| Satellite_ProductVersion | .NETTO | Gibt eine Zeichenfolge für das Feld "ProductVersion" in der Satellitenassembly an. |
| Satellite_TargetType | .NETTO | Gibt das Dateiformat der Ausgabedatei der Satellitenassembly als "Bibliothek", "exe" oder "win" an. Der Standardwert ist "library". |
| Satellite_Title | .NETTO | Gibt eine Zeichenfolge für das Feld "Titel" in der Satellitenassembly an. |
| Satellite_Trademark | .NETTO | Gibt eine Zeichenfolge für das Markenfeld in der Satellitenassembly an. |
| Satellite_Version | .NETTO | Gibt die Versionsinformationen für die Satellitenassembly an. |
| Satellite_Win32Icon | .NETTO | Fügt eine .ico Symboldatei in die Satellitenassembly ein. |
| Satellite_Win32Resource | .NETTO | Fügt eine Win32-Ressource (RES Datei) in die Satellitenassembly ein. |
| SGenToolPath | .NETTO | Ein optionaler Toolpfad, der angibt, wo SGen.exe erhalten werden soll, wenn die aktuelle Version von SGen.exe überschrieben wird. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| SGenUseProxyTypes | .NETTO | Ein boolescher Wert, der angibt, ob Proxytypen von SGen.exegeneriert werden sollen. Dies gilt nur, wenn GenerateSerializationAssemblies aktiviert ist. Das SGen-Ziel verwendet diese Eigenschaft, um das UseProxyTypes-Flag festzulegen. Diese Eigenschaft ist standardmäßig auf "true" festgelegt, und es gibt keine Benutzeroberfläche, um dies zu ändern. Um die Serialisierungsassembly für Nicht-Webservice-Typen zu generieren, fügen Sie diese Eigenschaft der Projektdatei hinzu, und legen Sie sie vor dem Importieren der Microsoft.Common.Targets oder der C#/VB.targetsauf "false" fest. |
| SkipInvalidConfigurations | Alle | Wenn true, generieren Sie eine Warnung für ungültige Plattform- und Konfigurationskombinationen, führen Sie jedoch keinen Buildfehler aus. wenn false oder nicht definiert (Standardeinstellung) einen Fehler generieren. |
| StartupObject | .NETTO | Gibt die Klasse oder das Modul an, die die Main-Methode oder Sub Main-Prozedur enthält. Diese Eigenschaft entspricht dem /main Compilerschalter. |
| SubsystemVersion | .NETTO | Gibt die Mindestversion des Subsystems an, das von der generierten ausführbaren Datei verwendet werden kann. Diese Eigenschaft entspricht dem /subsystemversion Compilerschalter. Informationen zum Standardwert dieser Eigenschaft finden Sie unter /subsystemversion (Visual Basic) oder /subsystemversion (C#-Compileroptionen). |
| TargetCompactFramework | .NETTO | Die Version von .NET Compact Framework, die zum Ausführen der Anwendung erforderlich ist, die Sie erstellen. Wenn Sie dies angeben, können Sie auf bestimmte Frameworkassemblys verweisen, auf die Sie möglicherweise nicht verweisen können. |
| TargetFrameworkVersion | .NETTO | Die Version von .NET Framework, die zum Ausführen der Anwendung erforderlich ist, die Sie erstellen. Wenn Sie dies angeben, können Sie auf bestimmte Frameworkassemblys verweisen, auf die Sie möglicherweise nicht verweisen können. |
| TreatWarningsAsErrors | .NETTO | Ein boolescher Parameter, der bei truealle Warnungen als Fehler behandelt wird. Dieser Parameter entspricht dem Compilerschalter /nowarn. |
| UseCommonOutputDirectory | .NETTO | Eine boolesche Eigenschaft, die Sie auf true festlegen können, wenn alle Buildausgaben in einer Lösung dasselbe Ausgabeverzeichnis verwenden sollen. Wenn true, wird die Ausgabe von referenzierten Projekten nicht in Projekte kopiert, die diese Abhängigkeiten verwenden, wie es normalerweise der Fall ist, wenn diese Einstellung falseist. Wenn Sie diesen Parameter auf true festlegen, wird das tatsächliche Ausgabeverzeichnis von Projekten nicht geändert. Sie müssen das Ausgabeverzeichnis trotzdem auf das gewünschte gemeinsame Ausgabeverzeichnis für jedes Projekt festlegen, für das es erforderlich ist. |
| UseHostCompilerIfAvailable | .NETTO | Ein boolescher Parameter, der, wenn true, bewirkt, dass die Buildaufgabe das In-Process-Compilerobjekt verwendet, wenn er verfügbar ist. Dieser Parameter wird nur von Visual Studio verwendet. |
| Utf8Output | .NETTO | Ein boolescher Parameter, der, wenn true, die Compilerausgabe mithilfe der UTF-8-Codierung protokolliert. Dieser Parameter entspricht dem Compilerschalter /utf8Output. |
| Eigenschafts- oder Parametername | Projekttypen | Beschreibung |
|---|---|---|
| VbcToolPath | Visual Basic | Ein optionaler Pfad, der einen anderen Speicherort für vbc.exe angibt, wenn die aktuelle Version von vbc.exe außer Kraft gesetzt wird. |
| VbcVerbosity | Visual Basic | Gibt die Ausführlichkeit der Ausgabe des Visual Basic-Compilers an. Gültige Werte sind "Quiet", "Normal" (Standardwert) oder "Verbose". |
| VisualStudioVersion | Alle | Gibt die Version von Visual Studio an, unter der dieses Projekt als ausgeführt werden soll. Wenn diese Eigenschaft nicht angegeben ist, legt MSBuild sie auf einen Standardwert von {VisualStudioMajorVersion}.0fest; Beispielsweise wird es für alle Versionen von Visual Studio 2022 17.0.Diese Eigenschaft wird in mehreren Projekttypen verwendet, um die Gruppe von Zielen anzugeben, die für den Build verwendet werden. Wenn ToolsVersion für ein Projekt auf 4.0 oder höher festgelegt ist, wird VisualStudioVersion verwendet, um anzugeben, welches Untertoolset verwendet werden soll. Weitere Informationen finden Sie unter Toolset (ToolsVersion). |
| WarningsAsErrors | .NETTO | Gibt eine Liste von Warnungen an, die als Fehler behandelt werden sollen. Dieser Parameter entspricht dem Compilerschalter /warnaserror. |
| WarningLevel | Alle | Gibt die Warnungsstufe an, die an die Compiler übergeben werden soll, um Warnungen zu geben, die vom Compiler ausgegeben werden. Diese Einstellung wirkt sich nicht auf MSBuild-Warnungen aus, die keine Ebenenbezeichnungen aufweisen. Siehe Warnungsstufe in der C#-Compilerdokumentation und /W (Warnungsstufe) in der C++-Compilerdokumentation. |
| WarningsNotAsErrors | .NETTO | Gibt eine Liste von Warnungen an, die nicht als Fehler behandelt werden. Dieser Parameter entspricht dem Compilerschalter /warnaserror. |
| Win32Manifest | .NETTO | Der Name der Manifestdatei, die in die endgültige Assembly eingebettet werden soll. Dieser Parameter entspricht dem Compilerschalter /win32Manifest. |
| Win32Resource | .NETTO | Der Dateiname der Win32-Ressource, die in die endgültige Assembly eingebettet werden soll. Dieser Parameter entspricht dem Compilerschalter /win32resource. |
Für .NET SDK-Projekte spezifische Eigenschaften, z. B. TargetFramework, werden unter Framework-Eigenschaftendokumentiert.