Elemento Target (MSBuild)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Contiene un insieme di attività da eseguire in sequenza in MSBuild.

<Target Name="Target Name"
        DependsOnTargets="DependentTarget"
        Inputs="Inputs"
        Outputs="Outputs"
        Condition="'String A' == 'String B'">
    <Task>... </Task>
    <OnError... />
</Target>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
Name	Attributo obbligatorio. Nome della destinazione.
DependsOnTargets	Attributo facoltativo. Destinazioni da eseguire prima che sia possibile eseguire questa destinazione o effettuare l'analisi delle dipendenze di livello superiore. Se sono specificate più destinazioni, queste sono separate da punti e virgola.
Inputs	Attributo facoltativo. Input di elementi per questa destinazione. Gli elementi all'interno dell'attributo vengono utilizzati come input nell'analisi delle dipendenze di livello superiore.
Outputs	Attributo facoltativo. Output previsti per questa destinazione. È possibile applicare trasformazioni agli elementi di input per generare elementi di output. Per ulteriori informazioni sulle trasformazioni, vedere Trasformazioni di MSBuild.
Condition	Attributo facoltativo. Condizione da valutare. Se la condizione restituisce false, il corpo della destinazione o di eventuali destinazioni impostate nell'attributo DependsOnTargets non verrà eseguito. Per ulteriori informazioni sulle condizioni, vedere Condizioni di MSBuild.

Elementi figlio

Elemento	Descrizione
Task	Crea ed esegue un'istanza di un'attività MSBuild. In una destinazione possono essere presenti zero o più attività.
OnError	Determina l'esecuzione di una o più destinazioni se l'attributo ContinueOnError è impostato su false per un'attività non riuscita. In una destinazione possono essere presenti zero o più elementi OnError. Gli elementi OnError eventualmente presenti devono comparire per ultimi all'interno dell'elemento Target.

Elementi padre

Elemento	Descrizione
Project	Elemento principale obbligatorio di un file di progetto MSBuild.

Note

La prima destinazione da eseguire viene specificata in fase di esecuzione. Le destinazioni possono contenere dipendenze da altre destinazioni. Ad esempio, una destinazione per la distribuzione dipende da una destinazione per la compilazione. Il modulo di gestione di MSBuild esegue le dipendenze nell'ordine in cui vengono visualizzate all'interno dell'attributo DependsOnTargets, da sinistra verso destra. Per ulteriori informazioni, vedere Destinazioni di MSBuild.

Anche se più destinazioni contengono una dipendenza da una specifica destinazione, questa viene eseguita una sola volta durante una generazione.

Se una destinazione viene ignorata perché il relativo attributo Condition restituisce false, è comunque possibile eseguirla richiamandola in una fase successiva della generazione. A questo punto, il relativo attributo Condition restituirà true.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato un elemento Target che esegue l'attività Csc.

<Target Name="Compile" DependsOnTarget="Resources" >
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

Vedere anche

Concetti

Destinazioni di MSBuild

Riferimenti dello schema del file di progetto MSBuild

Share via