Condividi tramite


Elemento Task di Target (MSBuild)

Crea ed esegue un'istanza di un'attività MSBuild. Il nome dell'elemento viene determinato dal nome dell'attività da creare.

<Destinazione progetto><>

Sintassi

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
Condition Attributo facoltativo. Condizione da valutare. Per altre informazioni, vedere Condizioni.
ContinueOnError Attributo facoltativo. Può contenere uno dei valori seguenti:

- WarnAndContinue o true. Quando un'attività ha esito negativo, l'esecuzione delle attività successive nell'elemento Target e della compilazione continua e tutti gli errori delle attività vengono considerati avvisi.
- ErrorAndContinue. Quando un'attività ha esito negativo, l'esecuzione delle attività successive nell'elemento Target e della compilazione continua e tutti gli errori delle attività vengono considerati errori.
- ErrorAndStop o false (impostazione predefinita). Quando un'attività ha esito negativo, le attività rimanenti nell'elemento Target e la compilazione non vengono eseguite e l'intero elemento Target e la compilazione vengono considerati come non riusciti.

Le versioni di .NET Framework precedenti alla 4.5 supportano solo i valori true e false.

Per altre informazioni, vedere Procedura: Ignorare gli errori nelle attività.
Parameter Obbligatorio se la classe dell'attività contiene una o più proprietà contrassegnate con l'attributo [Required].

Un parametro per l'attività definita dall'utente che contiene il valore del parametro come valore. L'elemento Task può includere qualsiasi numero di parametri, con ogni attributo mappato a una proprietà .NET nella classe dell'attività.

Elementi figlio

Elemento Descrizione
Output Archivia gli output dell'attività nel file di progetto. Possono esistere zero o più elementi Output in un'attività.

Elementi padre

Elemento Descrizione
Destinazione Elemento contenitore per le attività di MSBuild.

Osservazioni:

Un Task elemento in un file di progetto MSBuild crea un'istanza di un'attività, imposta le proprietà su di esso ed esegue tale elemento. L'elemento Output archivia i parametri di output nelle proprietà o negli elementi da usare in altri punti nel file di progetto.

In presenza di elementi OnError nell'elemento padre Target di un'attività, questi verranno comunque valutati se l'attività ha esito negativo e ContinueOnError ha il valore false. Per altre informazioni sulle attività, vedere Attività.

Esempio

L'esempio di codice seguente crea un'istanza della classe dell'attività Csc, imposta sei proprietà ed esegue l'attività. Dopo l'esecuzione, il valore della proprietà OutputAssembly dell'oggetto viene inserito in un elenco di elementi denominato FinalAssemblyName.

<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>

Vedi anche