Referenz zu MSBuild-Aufgaben

Aktualisiert: September 2010

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	Beschreibung
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 Boolean-Parameter. Ein Boolean-Ausdruck, der angibt, ob die übrigen Aufgaben im Ziel ausgeführt werden, wenn diese Aufgabe fehlschlägt. Die Aufgabe schlägt fehl, wenn die Execute-Methode entweder eine Ausnahme auslöst oder false zurückgibt. Wenn ContinueOnError auf true festgelegt wird, werden die übrigen Aufgaben ausgeführt, d. h., die fehlgeschlagene Aufgabe führt nicht dazu, dass das gesamte Ziel fehlschlägt. Wenn ContinueOnError auf false festgelegt wird, werden die übrigen Aufgaben nicht ausgeführt, und das gesamte Ziel schlägt fehl. Standardmäßig ist ContinueOnError auf false festgelegt.

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

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
September 2010	Visual C++-Aufgaben wurden in einen Unterabschnitt, Spezifische MSBuild-Aufgaben für Visual C++ verschoben.	Informationsergänzung.