Referenz zu MSBuild-Aufgaben

Aufgaben stellen den Code bereit, der während des Buildprozesses ausgeführt wird.Die Aufgaben in der folgenden Liste sind in MSBuild enthalten.Wenn Visual C++ installiert ist, sind zusätzliche Aufgaben zum Erstellen von Visual C++-Projekten verfügbar.Weitere Informationen finden Sie unter Spezifische MSBuild-Aufgaben für Visual C++.

Zusätzlich zu den Parametern, die in den Themen in diesem Abschnitt aufgeführt werden, kann jede Aufgabe auch über die folgenden Parameter verfügen:

Parameter	Description
Condition	Optionaler String-Parameter. Ein Boolean-Ausdruck, mit dem vom MSBuild-Modul ermittelt wird, ob diese Aufgabe ausgeführt wird.Weitere Informationen zu den Bedingungen, die von MSBuild unterstützt werden, finden Sie unter MSBuild-Bedingungen.
ContinueOnError	Optionaler - Parameter.Kann einen der folgenden Werte enthalten: WarnAndContinue oder true.Wenn eine Aufgabe fehlschlägt, werden folgende Aufgaben im Ziel-Element und im Build fort, um auszuführen, und alle Fehler von der Aufgabe werden als Warnungen behandelt. ErrorAndContinue.Wenn eine Aufgabe fehlschlägt, werden folgende Aufgaben im Target-Element und im Build fort, um auszuführen, und alle Fehler von der Aufgabe werden als Fehler behandelt. ErrorAndStop oder false (Standard).Wenn eine Aufgabe fehlschlägt, werden die übrigen Aufgaben im Target-Element und im Build nicht ausgeführt, und das gesamte Target-Element und der Build wird angenommen fehlgeschlagen sein. .NET Framework-Versionen vor 4,5 unterstützten nur die true und false-Werte. Weitere Informationen finden Sie unter Gewusst wie: Ignorieren von Fehlern in Aufgaben.

In diesem Abschnitt

• Aufgabenbasisklasse
  Fügt den Aufgaben, die sich von der Task-Klasse ableiten, mehrere Parameter hinzu.

• TaskExtension-Basisklasse
  Fügt den Aufgaben, die sich von der TaskExtension-Klasse ableiten, mehrere Parameter hinzu.

• ToolTaskExtension-Basisklasse
  Fügt den Aufgaben, die sich von der ToolTaskExtension-Klasse ableiten, mehrere Parameter hinzu.

• AL (Assembly Linker)-Aufgabe
  Erstellt eine Assembly mit einem Manifest aus einer oder mehreren Dateien, bei denen es sich um Module oder Ressourcendateien handelt.

• AspNetCompiler-Aufgabe
  Umschließt aspnet_compiler.exe, ein Dienstprogramm, mit dem ASP.NET-Anwendungen vorkompiliert werden.

• AssignCulture-Aufgabe
  Weist Elementen Kulturbezeichner zu.

• AssignProjectConfiguration-Aufgabe
  Akzeptiert eine Liste von Konfigurationszeichenfolgen und weist sie angegebenen Projekten zu.

• AssignTargetPath-Aufgabe
  Akzeptiert eine Liste von Dateien und fügt <TargetPath>-Attribute hinzu, sofern sie noch nicht angegeben wurden.

• CallTarget-Aufgabe
  Ruft ein Ziel in der Projektdatei auf.

• CombinePath-Aufgabe
  Kombiniert die angegebenen Pfade in einem einzelnen Pfad.

• ConvertToAbsolutePath-Aufgabe
  Konvertiert einen relativen Pfad oder einen Verweis in einen absoluten Pfad.

• Copy-Aufgabe
  Kopiert Dateien an einen neuen Speicherort.

• CreateCSharpManifestResourceName-Aufgabe
  Erstellt einen Manifestnamen im Visual C#-Format auf der Grundlage eines bestimmten RESX-Dateinamens oder einer anderen Ressource.

• CreateItem-Aufgabe
  Füllt Elementauflistungen aus den Eingabeelementen auf, sodass Elemente aus einer Liste in eine andere kopiert werden können.

• CreateProperty-Aufgabe
  Füllt Eigenschaften aus den Eingabewerten auf. Auf diese Weise können Werte von einer Eigenschaft oder Zeichenfolge in eine andere kopiert werden.

• CreateVisualBasicManifestResourceName-Aufgabe
  Erstellt einen Manifestnamen im Visual Basic-Format auf der Grundlage eines bestimmten RESX-Dateinamens oder einer anderen Ressource.

• Csc-Aufgabe
  Ruft den Visual C#-Compiler auf, um ausführbare Dateien, Dynamic Link Librarys oder Codemodule zu erzeugen.

• Delete-Aufgabe
  Löscht die angegebenen Dateien.

• Error-Aufgabe
  Hält einen Build an und protokolliert einen Fehler anhand einer ausgewerteten Bedingungsanweisung.

• Exec-Aufgabe
  Führt das angegebene Programm oder den angegebenen Befehl mit den angegebenen Argumenten aus.

• FindAppConfigFile-Aufgabe
  Sucht in den angegebenen Listen die Datei app.config, sofern vorhanden.

• FindInList-Aufgabe
  Sucht ein Element in einer angegebenen Liste, das über eine entsprechende Elementspezifikation verfügt.

• FindUnderPath-Aufgabe
  Ermittelt, welche Elemente in der angegebenen Elementauflistung im angegebenen Ordner und allen Unterordnern vorhanden sind.

• FormatUrl-Aufgabe
  Konvertiert eine URL in ein richtiges URL-Format.

• FormatVersion-Aufgabe
  Fügt die Revisionsnummer an die Versionsnummer an.

• GenerateApplicationManifest-Aufgabe
  Generiert ein ClickOnce-Anwendungsmanifest oder ein systemeigenes Manifest.

• GenerateBootstrapper-Aufgabe
  Bietet eine Möglichkeit zur Automatisierung von Erkennung, Download und Installation einer Anwendung und der erforderlichen Komponenten.

• GenerateDeploymentManifest-Aufgabe
  Generiert ein ClickOnce-Bereitstellungsmanifest.

• GenerateResource-Aufgabe
  Konvertiert TXT-Dateien und RESX-Dateien in binäre RESOURCES-Dateien der Common Language Runtime.

• GenerateTrustInfo-Aufgabe
  Generiert die Vertrauenswürdigkeit der Anwendung aus dem Basismanifest sowie aus der TargetZone-Eigenschaft und den ExcludedPermissions-Parametern.

• GetAssemblyIdentity-Aufgabe
  Ruft die Assemblyidentitäten aus den angegebenen Dateien ab und gibt die Identitätsinformationen aus.

• GetFrameworkPath-Aufgabe
  Ruft den Pfad zu den .NET Framework-Assemblys ab.

• GetFrameworkSdkPath-Aufgabe
  Ruft den Pfad zu Windows Software Development Kit (SDK) ab.

• GetReferenceAssemblyPaths-Aufgabe
  Gibt die Verweisassemblypfade der verschiedenen Frameworks zurück.

• LC-Aufgabe
  Generiert eine LICENSE-Datei aus einer LICX-Datei.

• MakeDir-Aufgabe
  Erstellt Verzeichnisse und ggf. übergeordnete Verzeichnisse.

• Message-Aufgabe
  Protokolliert eine Meldung während eines Builds.

• Move-Aufgabe
  Verschiebt Dateien an eine neue Position.

• MSBuild-Aufgabe
  Erstellt MSBuild-Projekte aus einem anderen MSBuild-Projekt.

• ReadLinesFromFile-Aufgabe
  Liest eine Liste von Elementen aus einer Textdatei.

• RegisterAssembly-Aufgabe
  Liest die Metadaten in der angegebenen Assembly und fügt der Registrierung die notwendigen Einträge hinzu.

• RemoveDir-Aufgabe
  Entfernt die angegebenen Verzeichnisse und alle enthaltenen Dateien und Unterverzeichnisse.

• RemoveDuplicates-Aufgabe
  Entfernt doppelte Elemente aus der angegebenen Elementauflistung.

• RequiresFramework35SP1Assembly-Aufgabe
  Bestimmt, ob die Anwendung .NET Framework 3.5 SP1 erfordert.

• ResGen-Aufgabe
  Veraltet.Verwenden Sie die GenerateResource-Aufgabe-Aufgabe, um TXT-Dateien und RESX-Dateien in binäre RESOURCES-Dateien der Common Language Runtime und zurück in TXT-Dateien bzw. RESX-Dateien zu konvertieren.

• ResolveAssemblyReference-Aufgabe
  Bestimmt alle Assemblys, die von den angegebenen Assemblys abhängen.

• ResolveComReference-Aufgabe
  Erstellt eine Liste mit mindestens einem Typbibliotheknamen oder mindestens einer TLB-Datei und löst die Typbibliotheken in Speicherorten auf dem Datenträger auf.

• ResolveKeySource-Aufgabe
  Ermittelt die Quelle für Schlüssel für einen starken Namen.

• ResolveManifestFiles-Aufgabe
  Löst die folgenden Elemente im Buildprozess in Dateien für die Manifestgenerierung auf: erstellte Elemente, Abhängigkeiten, Satelliten, Inhalte, Debugsymbole und Dokumentation.

• ResolveNativeReference-Aufgabe
  Löst systemeigene Verweise auf.

• ResolveNonMSBuildProjectOutput-Aufgabe
  Bestimmt die Ausgabedateien für Projektverweise, die keine MSBuild-Projektverweise sind.

• SGen-Aufgabe
  Erstellt eine XML-Serialisierungsassembly für Typen in der angegebenen Assembly.

• SignFile-Aufgabe
  Signiert die angegebene Datei mit dem angegebenen Zertifikat.

• Touch-Aufgabe
  Legt die Zugriffs- und die Änderungszeiten für Dateien fest.

• UnregisterAssembly-Aufgabe
  Hebt die Registrierung der angegebenen Assemblys für COM-Interop-Zwecke auf.

• UpdateManifest-Aufgabe
  Aktualisiert ausgewählte Eigenschaften in einem Manifest und führt eine erneute Signierung aus.

• Vbc-Aufgabe
  Ruft den Visual Basic-Compiler auf, um ausführbare Dateien, Dynamic Link Librarys oder Codemodule zu erzeugen.

• Warning-Aufgabe
  Protokolliert eine Warnung während eines Buildvorgangs auf der Grundlage einer ausgewerteten Bedingungsanweisung.

• WriteCodeFragment-Aufgabe
  Generiert eine temporäre Codedatei mit dem angegebenen generierten Codefragment.Löscht die Datei nicht.

• WriteLinesToFile-Aufgabe
  Schreibt die angegebenen Elemente in die angegebene Textdatei.

• XmlPeek-Aufgabe
  Gibt Werte wie von einer XPath-Abfrage angegeben aus einer XML-Datei zurück.

• XmlPoke-Aufgabe
  Legt Werte wie von einer XPath-Abfrage angegeben in einer XML-Datei fest.

• XslTransformation-Aufgabe
  Transformiert eine XML-Eingabe mithilfe einer Extensible Stylesheet Language Transformation (XSLT) oder kompilierten XSLT und gibt das Ergebnis in einem Ausgabegerät oder einer Datei aus.

Siehe auch

Konzepte

Schreiben von Aufgaben

MSBuild-Aufgaben

Weitere Ressourcen

MSBuild-Referenz