Referenz zu MSBuild-Tasks

  • Artikel

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

Zusätzlich zu den Parametern, die in den Themen in diesem Abschnitt aufgeführt sind, verfügt jeder Task ebenfalls über folgende Parameter:

Parameter Beschreibung
Condition Optionaler String-Parameter.

Ein Boolean-Ausdruck, mit dem die MSBuild-Engine bestimmt, ob diese Aufgabe ausgeführt wird. Informationen zu den von MSBuild unterstützten Bedingungen finden Sie unter Bedingungen.
ContinueOnError Dieser Parameter ist optional. Kann einen oder mehrere der folgenden Werte enthalten:

- WarnAndContinue oder true. Wenn eine Aufgabe fehlschlägt, werden nachfolgende Aufgabe im Element Ziel und im Build weiterhin ausgeführt, und alle Fehler von der Aufgabe werden als Warnungen behandelt.
- ErrorAndContinue. Wenn eine Aufgabe fehlschlägt, werden nachfolgende Aufgabe im Element Target und im Build weiterhin ausgeführt, und alle Fehler von der Aufgabe werden als Fehler behandelt.
- ErrorAndStop oder false (Standard). Wenn eine Aufgabe fehlschlägt, werden die übrigen Aufgaben im Element Target und im Build nicht ausgeführt, und das komplette Element Target sowie der Build wird als fehlgeschlagen betrachtet.

Versionen von .NET Framework vor 4.5 unterstützten nur die Werte true und false.

Weitere Informationen finden Sie unter Vorgehensweise: Ignorieren von Fehlern in Aufgaben.

In diesem Abschnitt

Fügt mehrere Parameter zu den Aufgaben hinzu, die von der Task-Klasse abgeleitet werden Ist nicht dafür vorgesehen, direkt verwendet zu werden.

Fügt mehrere Parameter zu den Aufgaben hinzu, die von der TaskExtension-Klasse abgeleitet werden Ist nicht dafür vorgesehen, direkt verwendet zu werden.

Fügt mehrere Parameter zu den Aufgaben hinzu, die von der ToolTaskExtension-Klasse abgeleitet werden Ist nicht dafür vorgesehen, direkt verwendet zu werden.

Erstellt eine Assembly mit einem Manifest aus einer oder mehreren Dateien, die entweder Module oder Ressourcendateien darstellen

Umfasst aspnet_compiler.exe, wobei es sich um ein Hilfsprogramm zum Vorkompilieren von ASP.NET-Anwendungen handelt.

Weist Elementen Kulturbezeichner zu

Akzeptiert eine Liste von Konfigurationszeichenfolgen und weist diese den angegebenen Projekten zu

Akzeptiert eine Liste von Dateien und fügt <TargetPath>-Attribute hinzu, wenn diese nicht bereits angegeben wurden

Ruft ein Ziel in der Projektdatei auf

Kombiniert die angegebenen Pfade zu einem einzigen Pfad.

Konvertiert einen relativen Pfad oder einen Verweis in einen absoluten Pfad

Kopiert Dateien an einen neuen Speicherort

Erstellt einen Manifestnamen im C#-Stil aus einem angegebenen RESX-Dateinamen oder aus einer anderen Ressource.

Füllt die Elementauflistungen mithilfe der Eingabeelemente auf. Dadurch können Elemente von einer Liste in eine andere kopiert werden

Füllt Eigenschaften mithilfe der Eingabewerte auf. Dadurch können Werte von einer Eigenschaft oder Zeichenfolge in eine andere kopiert werden

Erstellt einen Manifestnamen im Visual Basic-Stil aus einem angegebenen RESX-Dateinamen oder aus einer anderen Ressource.

Ruft den Visual C#-Compiler auf, um ausführbare Dateien, DLLs oder Codemodule zu erzeugen

Löscht die angegebene Datei.

Lädt eine Datei herunter und speichert diese am angegebenen Speicherort.

Beendet einen Build, und protokolliert einen Fehler basierend auf einer ausgewerteten Bedingungsanweisung.

Führt das angegebene Programm oder den Befehl mit den angegebenen Argumenten aus

Sucht nach der Datei app.config (falls vorhanden) in den angegebenen Listen.

Sucht ein Element in einer angegebenen Liste, das über die entsprechende Elementspezifikation verfügt

Bestimmt, welche Elemente in der angegebenen Elementauflistung im angegebenen Ordner und allen Unterordnern vorhanden sind

Konvertiert eine URL in ein gültiges URL-Format

Fügt die Revisionsnummer an die Versionsnummer an.

Generiert ein ClickOnce-Anwendungsmanifest oder ein natives Manifest.

Bietet eine automatisierte Methode zum Erkennen, Herunterladen und Installieren einer Anwendung sowie ihrer erforderlichen Komponenten.

Generiert ein ClickOnce-Bereitstellungsmanifest.

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

Generiert die Anwendungsvertrauensstellung aus dem Basismanifest und aus den Parametern TargetZone und ExcludedPermissions

Ruft die Assemblyidentitäten aus den angegebenen Dateien ab und gibt die Identitätsinformation aus

Berechnet Prüfsummen der Inhalte einer Datei oder mehrerer Dateien.

Ruft den Pfad zu den .NET Framework-Assemblys ab.

Ruft den Pfad zum Windows Software Development Kit (SDK) ab.

Gibt den Verweisassemblypfad der verschiedenen Frameworks zurück

Generiert eine LICENSE-Datei aus einer LICX-Datei.

Erstellt Verzeichnisse und ggf. übergeordnete Verzeichnisse

Protokolliert eine Meldung während eines Builds

Verschiebt Dateien in einen neuen Speicherort.

Erstellt MSBuild-Projekte aus einem anderen MSBuild-Projekt.

Liest eine Liste von Elementen aus einer Textdatei

Liest die Metadaten in der angegebenen Assembly und fügt der Registrierung die notwendigen Einträge hinzu

Entfernt die angegebenen Verzeichnisse und alle enthaltenen Dateien und Unterverzeichnisse

Entfernt doppelte Elemente aus der angegebenen Elementauflistung

Bestimmt, ob die Anwendung .NET Framework 3.5 SP1 erfordert

  • ResGen-Aufgabe

Veraltet. Verwenden Sie die GenerateResource-Aufgabe, um TXT- und RESX-Dateien in und aus binären RESOURCES-Dateien der Common Language Runtime zu konvertieren.

Bestimmt alle Assemblys, die von den angegebenen Assemblys abhängig sind.

Akzeptiert eine Liste aus mindestens einem Typbibliotheksnamen oder mindestens einer TLB-Datei und löst diese Bibliotheken an Speicherorten auf Datenträgern auf.

Bestimmt die Schlüsselquelle mit starkem Namen

Löst folgende Elemente im Buildprozess in Dateien für die Manifestgenerierung auf: erstellte Elemente, Abhängigkeiten, Satelliten, Inhalte, Debugsymbole und Dokumentationen

Löst native Verweise auf.

Bestimmt die Ausgabedateien für Nicht-MSBuild-Projektverweise

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

Signiert die angegebene Datei mit dem angegebenen Zertifikat.

Legt den Zugriff und den Änderungszeitpunkt für Dateien fest

Hebt die Registrierung der angegebenen Assemblys für COM-Interop-Zwecke auf

Entzippt ein ZIP-Archiv am angegebenen Speicherort.

Aktualisiert die ausgewählten Eigenschaften in einem Manifest und führt das Signieren erneut aus.

Ruft den Visual Basic-Compiler auf, um ausführbare Dateien, DLLs oder Codemodule zu erzeugen

Überprüft, ob die Datei mit dem erwarteten Dateihash übereinstimmt.

Protokolliert während eines Builds eine Warnung, die auf einer ausgewerteten Bedingungsanweisung basiert

Generiert eine temporäre Codedatei, indem das angegebene generierte Codefragment verwendet wird. Die Datei wird nicht gelöscht.

Schreibt die angegebenen Elemente in die angegebene Textdatei

Gibt die Werte einer XML-Datei wie von der XPath-Abfrage angegeben zurück

Legt die Werte einer XML-Datei wie von der XPath-Abfrage angegeben fest

Transformiert eine XML-Eingabe mithilfe von Extensible Stylesheet Language Transformation (XSLT) oder kompiliertem XSLT-Code bzw. kompilierten XSLT-Ausgaben für ein Ausgabegerät oder eine Ausgabedatei

Erstellt ein ZIP-Archiv aus den Inhalten eines Verzeichnisses.

Siehe auch