Angeben von Buildereignissen
Mithilfe von Buildereignissen können Befehle festgelegt werden, die vor dem Buildvorgang, vor dem Verknüpfungsvorgang oder nach dem Buildvorgang ausgeführt werden.
Buildereignisse werden nur dann ausgeführt, wenn im Buildvorgang diese Punkte erfolgreich erreicht werden.Wenn während des Buildvorgangs ein Fehler ausgegeben wird, tritt kein Postbuildereignis auf. Wenn der Fehler vor der Verknüpfungsphase auftritt, wird weder das Prälinkereignis noch das Postbuildereignis erstellt.Das Prälinkereignis tritt außerdem nicht auf, wenn keine Dateien verknüpft werden müssen.In Projekten, die keinen Verknüpfungsschritt enthalten, tritt das Prälinkereignis ebenfalls nicht auf.
Wenn keine Dateien erstellt werden müssen, treten keine Buildereignisse auf.
Allgemeine Informationen zu Buildereignissen finden Sie unter Grundlagen benutzerdefinierter Buildschritte und Buildereignisse.
So legen Sie ein Buildereignis fest
Wählen Sie im Projektmappen-Explorer das Projekt aus, für das das Buildereignis festgelegt werden soll.
Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts.Weitere Informationen finden Sie unter Ändern von Projekteinstellungen.
Wählen Sie im Ordner Buildereignisse eine Buildereignis-Eigenschaftenseite aus.
Legen Sie die dem Buildereignis zugeordneten Eigenschaften fest:
Geben Sie in der Befehlszeile einen Befehl so an, als ob Sie ihn an der Eingabeaufforderung eingeben würden.Geben Sie einen gültigen Befehl oder eine Batchdatei und alle erforderlichen Eingabe- oder Ausgabedateien an.Geben Sie den Batchbefehl call vor dem Namen einer Batchdatei an, um sicherzustellen, dass alle nachfolgenden Befehle ausgeführt werden.
Mehrere Eingabe- und Ausgabedateien können symbolisch mit MSBuild-Makros angegeben werden.Weitere Informationen finden Sie unter zur Angabe des Speicherorts der Dateien oder der Namen der Dateisätze finden Sie unter Makros für Buildbefehle und -eigenschaften.
Da das Zeichen "%" von MSBuild reserviert wird, wenn eine Umgebungsvariable angegeben wird, ersetzen Sie jedes %-Escapezeichen durch die hexadezimale Escapesequenz %25.Ersetzen Sie z. B. %WINDIR% durch %25WINDIR%25:MSBuild ersetzt jede %25-Sequenz durch das Zeichen %, bevor auf die Umgebungsvariable zugegriffen wird.
Geben Sie unter Beschreibung eine Beschreibung für dieses Ereignis ein.Die Beschreibung wird beim Auftreten dieses Ereignisses im Ausgabefenster angezeigt.
Geben Sie unter Vom Build ausschließen die Option Ja an, wenn das Ereignis nicht ausgeführt werden soll.
Siehe auch
Referenz
Grundlagen benutzerdefinierter Buildschritte und Buildereignisse
Problembehandlung für Buildanpassungen