Elemento Task (MSBuild)

Articolo
03/05/2013

Crea ed esegue un'istanza di un'attività MSBuild.Il nome dell'elemento è determinato dal nome dell'attività che viene creata.

<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 ulteriori informazioni, vedere Condizioni di MSBuild.
ContinueOnError	Attributo facoltativo.Può contenere uno dei seguenti valori: WarnAndContinue o true.Quando un'attività non riesce, le attività successive nell'elemento Destinazione e nella compilazione continua a eseguire e tutti gli errori dall'attività vengono trattati come avvisi. ErrorAndContinue.Quando un'attività non riesce, le attività successive nell'elemento Target e nella compilazione continua a eseguire e tutti gli errori dall'attività sono considerati come errori. ErrorAndStop o false (impostazione predefinita).Quando un'attività non riesce, le attività rimanenti nell'elemento Target e nella compilazione non vengono eseguite e l'intero elemento Target e la compilazione viene considerato dell'errata esecuzione. Le versioni di .NET Framework precedente alla 4,5 supportano i valori false e solo true. Per ulteriori 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]. Parametro dell'attività definito dall'utente che contiene come valore quello del parametro.Nell'elemento Task può essere presente un numero qualsiasi di parametri. Ciascun attributo di tale elemento corrisponde a una proprietà .NET nella classe dell'attività.

Condition

Attributo facoltativo.Condizione da valutare.Per ulteriori informazioni, vedere Condizioni di MSBuild.

ContinueOnError

Attributo facoltativo.Può contenere uno dei seguenti valori:

WarnAndContinue o true.Quando un'attività non riesce, le attività successive nell'elemento Destinazione e nella compilazione continua a eseguire e tutti gli errori dall'attività vengono trattati come avvisi.
ErrorAndContinue.Quando un'attività non riesce, le attività successive nell'elemento Target e nella compilazione continua a eseguire e tutti gli errori dall'attività sono considerati come errori.
ErrorAndStop o false (impostazione predefinita).Quando un'attività non riesce, le attività rimanenti nell'elemento Target e nella compilazione non vengono eseguite e l'intero elemento Target e la compilazione viene considerato dell'errata esecuzione.

Le versioni di .NET Framework precedente alla 4,5 supportano i valori false e solo true.

Per ulteriori 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].

Parametro dell'attività definito dall'utente che contiene come valore quello del parametro.Nell'elemento Task può essere presente un numero qualsiasi di parametri. Ciascun attributo di tale elemento corrisponde a una proprietà .NET nella classe dell'attività.

Elementi figlio

Elemento	Descrizione
Output	Archivia gli output dell'attività nel file di progetto.In un'attività possono essere presenti zero o più elementi Output.

Elementi padre

Elemento	Descrizione
Destinazione	Elemento contenitore per le attività MSBuild.

Note

Un elemento Task in un file di progetto MSBuild crea un'istanza di un'attività, ne imposta le proprietà e la esegue.L'elemento Output archivia i parametri di output nelle proprietà o negli elementi da utilizzare in altri punti del file di progetto.

Se sono presenti elementi OnError nell'elemento Target padre di un'attività, questi verranno comunque valutati se l'attività ha esito negativo e il valore di ContinueOnError è impostato su false.Per ulteriori informazioni sulle attività, vedere Attività di MSBuild.

Esempio

Nell'esempio di codice riportato di seguito viene creata un'istanza della classe dell'attività Csc, vengono impostate sei proprietà e viene eseguita 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>

Vedere anche

Concetti

Attività di MSBuild

Riferimenti dello schema del file di progetto MSBuild

Altre risorse

Riferimenti delle attività MSBuild

Condividi tramite