Elemento Task (MSBuild)

Articolo
08/11/2011

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="true/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
Condition	Attributo facoltativo. Condizione da valutare. Per ulteriori informazioni, vedere Condizioni di MSBuild.
ContinueOnError	Attributo facoltativo. Se non è specificato, questo attributo booleano viene impostato sul valore predefinito false. Se l'attributo ContinueOnError è impostato su false e un'attività ha esito negativo, le attività rimanenti dell'elemento Target non vengono eseguite e l'intero elemento Target viene considerato non riuscito. Se l'attributo è impostato su true, le attività successive nell'elemento Target verranno eseguite anche se l'attività corrente ha esito negativo e tutti gli errori generati dall'attività verranno considerati come avvisi.
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. Se non è specificato, questo attributo booleano viene impostato sul valore predefinito false. Se l'attributo ContinueOnError è impostato su false e un'attività ha esito negativo, le attività rimanenti dell'elemento Target non vengono eseguite e l'intero elemento Target viene considerato non riuscito.

Se l'attributo è impostato su true, le attività successive nell'elemento Target verranno eseguite anche se l'attività corrente ha esito negativo e tutti gli errori generati dall'attività verranno considerati come avvisi.

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