Angeben von Buildereignissen

Sie können Buildereignisse verwenden, um Befehle festzulegen, die vor dem Verknüpfungsvorgang oder nach Beenden des Builds ausgeführt werden.

Buildereignisse werden nur ausgeführt, wenn der Build die betreffenden Punkte im Buildprozess erfolgreich erreicht. Wenn ein Fehler im Build auftritt, findet das Postbuildereignis nicht statt. Wenn der Fehler vor der Verknüpfungsphase auftritt, finden weder das Prälink- noch das Postbuildereignis statt. Darüber hinaus findet das Prälinkereignis nicht statt, wenn keine Dateien verknüpft werden müssen. Das Prälinkereignis ist ebenfalls nicht in Projekten verfügbar, die keinen Verknüpfungsschritt enthalten.

Wenn keine Dateien erstellt werden müssen, finden keine Buildereignisse statt.

Allgemeine Informationen zu Buildereignissen finden Sie unter Understanding Custom Build Steps and Build Events (Grundlagen benutzerdefinierter Buildschritte und Buildereignisse).

Angeben eines Buildereignisses

1. Klicken Sie im Projektmappen-Explorer auf das Projekt, für das Sie das Buildereignis angeben möchten.

2. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Weitere Informationen erhalten Sie unter Set C++ compiler and build properties in Visual Studio (Festlegen der Compiler- und Buildeigenschaften (C++) in Visual Studio).

3. Wählen Sie im Ordner Buildereignisse eine Buildereignis-Eigenschaftenseite aus.

4. Geben Sie die Eigenschaften an, die zu dem Buildereignis gehören:

   • Geben Sie in der Befehlszeile einen Befehl so ein, wie Sie ihn über die Eingabeaufforderung eingeben würden. Geben Sie einen gültigen Befehl oder eine Batchdatei sowie alle erforderlichen Ein- und Ausgabedateien an. Geben Sie den Batchbefehl call vor dem Namen einer Batchdatei an, um sicherzustellen, dass alle nachfolgenden Befehle ausgeführt werden.

     Mehrere Ein- und Ausgabedateien können symbolisch mit MSBuild-Makros angegeben werden. Weitere Informationen zum Angeben des Speicherorts von Dateien oder der Namen mehrerer Dateien finden Sie unter Allgemeine Makros für MSBuild-Befehle und-Eigenschaften.

     Da das Zeichen „%“ von MSBuild reserviert ist, ersetzen Sie jedes %-Escapezeichen durch die Escapesequenz für Hexadezimalzahlen %25, wenn Sie eine Umgebungsvariable angeben. Ersetzen Sie beispielsweise %WINDIR% durch %25WINDIR%25. MSBuild ersetzt jede %25-Sequenz mit dem %-Zeichen, bevor auf die Umgebungsvariablen zugegriffen wird.

   • Geben Sie unter Beschreibung für dieses Ereignis eine Beschreibung ein. Wenn dieses Ereignis auftritt, wird die Beschreibung im Ausgabefenster ausgegeben.

   • Geben Sie für vom Build ausgeschlossenJa an, wenn das Ereignis nicht ausgeführt werden soll.

Siehe auch

Grundlagen benutzerdefinierter Buildschritte und Buildereignisse
Gängige Makros für Buildbefehle und -eigenschaften
Problembehandlung für Buildanpassungen