Elemento UsingTask (MSBuild)
Consente di eseguire il mappa dell'attività a cui si fa riferimento in un elemento Task all'assembly in cui è contenuta l'implementazione dell'attività.
<UsingTask TaskName="TaskName"
AssemblyName = "AssemblyName"
TaskFactory = "ClassName"
Condition="'String A'=='String B'" />
Attributi ed elementi
Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.
Attributi
Attributo |
Descrizione |
|---|---|
AssemblyName |
È necessario l'attributo AssemblyName oppure l'attributo AssemblyFile. Nome dell'assembly da caricare.L'attributo AssemblyName accetta assembly con nome sicuro, anche se non sono richiesti.L'utilizzo di questo attributo equivale al caricamento di un assembly tramite il metodo Load di .NET Framework. Non è possibile utilizzare questo attributo se viene utilizzato l'attributo AssemblyFile. |
AssemblyFile |
È obbligatorio l'attributo AssemblyName o AssemblyFile. Percorso del file dell’assembly.Questo attributo accetta percorsi completi o relativi.I percorsi relativi si riferiscono alla directory del file di progetto o del file con estensione targets in cui è dichiarato l'elemento UsingTask.L'utilizzo di questo attributo equivale al caricamento di un assembly tramite il metodo LoadFrom di .NET Framework. Non è possibile utilizzare questo attributo se viene utilizzato l'attributo AssemblyName. |
TaskFactory |
Attributo facoltativo. Specifica la classe nell'assembly che è responsabile della generazione di istanze del nome Task specificato. L'utente può inoltre specificare un oggetto TaskBody come elemento figlio ricevuto dalla factory delle attività e utilizzato per generare l'attività.Il contenuto di TaskBody è specifico della factory delle attività. |
TaskName |
Attributo obbligatorio. Nome dell'attività a cui fare riferimento da un assembly.Se è possibile che si verifichino ambiguità, questo attributo deve sempre specificare spazi dei nomi completi.In caso di ambiguità, MSBuild sceglie una corrispondenza arbitraria che può produrre risultati imprevisti. |
Condition |
Attributo facoltativo. Condizione da valutare.Per ulteriori informazioni, vedere Condizioni di MSBuild. |
Elementi figlio
Elemento |
Descrizione |
|---|---|
Set di parametri visualizzato nell'attività generata dalla classe TaskFactory specificata. |
|
I dati che vengono passati alla classe TaskFactory per generare un'istanza dell'attività. |
Elementi padre
Elemento |
Descrizione |
|---|---|
Elemento radice obbligatorio di un file di progetto MSBuild. |
Note
È possibile fare riferimento a variabili di ambiente, proprietà della riga di comando e proprietà a livello di progetto presenti in una posizione qualsiasi all'interno dell'elemento UsingTask, a condizione che quest'ultimo venga visualizzato nel file di progetto in modo esplicito o tramite un file di progetto importato.Per ulteriori informazioni, vedere Attività di MSBuild.
[!NOTA]
Le proprietà a livello di progetto non hanno alcun effetto se l'elemento UsingTask proviene da uno dei file tasks registrati a livello globale con il motore MSBuild.Le proprietà a livello di progetto non sono globali per MSBuild.
In MSBuild 4.0, l'utilizzo delle attività può essere caricato dai file con estensione overridetask.
Esempio
Nell'esempio riportato di seguito viene illustrato come utilizzare l'elemento UsingTask con un attributo AssemblyName.
<UsingTask TaskName="MyTask" AssemblyName="My.Assembly" TaskFactory="MyTaskFactory">
<ParameterGroup>
<Parameter1 ParameterType="System.String" Required="False" Output="False"/>
<Parameter2 ParameterType="System.Int" Required="True" Output="False"/>
...
</ParameterGroup>
<TaskBody>
... Task factory-specific data ...
</TaskBody>
</UsingTask>
Nell'esempio riportato di seguito viene illustrato come utilizzare l'elemento UsingTask con un attributo AssemblyFile.
<UsingTask TaskName="Email"
AssemblyFile="c:\myTasks\myTask.dll" />
Vedere anche
Concetti
Riferimenti dello schema del file di progetto MSBuild