Elemento UsingTask (MSBuild)
Aggiornamento: novembre 2007
Mappa l'attività a cui si fa riferimento in un elemento Task all'assembly che contiene l'implementazione dell'attività.
<UsingTask TaskName="TaskName"
AssemblyName = "AssemblyName"
Condition="'String A'=='String B'" />
Attributi ed elementi
Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio e padre.
Attributi
Attributo |
Descrizione |
---|---|
AssemblyName |
È obbligatorio l'attributo AssemblyName o AssemblyFile. Nome dell'assembly da caricare. L'attributo AssemblyName accetta assembly con nome sicuro, anche se non sono richiesti. Utilizzare questo attributo equivale a caricare 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 dell'assembly. Questo attributo accetta sia percorsi completi che relativi. I percorsi relativi si riferiscono alla directory del file di progetto o targets in cui è dichiarato l'elemento UsingTask. Utilizzare questo attributo equivale a caricare un assembly tramite il metodo LoadFrom di .NET Framework. Non è possibile utilizzare questo attributo se viene utilizzato l'attributo AssemblyName. |
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
Nessuno.
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. Queste proprietà non sono globali per MSBuild.
Esempio
Nell'esempio riportato di seguito viene illustrato come utilizzare l'elemento UsingTask con un attributo AssemblyName.
<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
AssemblyName="Microsoft.Build.Tasks" />
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