Elemento Task di Target (MSBuild)

Articolo
08/25/2023

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

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>

Share via