UsingTask-Element (MSBuild)
Ordnet die Aufgabe, auf die in einem Task-Element verwiesen wird, der Assembly zu, die die Implementierung der Aufgabe enthält.
<UsingTask TaskName="TaskName"
AssemblyName = "AssemblyName"
TaskFactory = "ClassName"
Condition="'String A'=='String B'" />
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
AssemblyName |
Das AssemblyName-Attribut oder das AssemblyFile-Attribut ist erforderlich. Der Name der zu ladenden Assembly. Das AssemblyName-Attribut akzeptiert zwar Assemblys mit starken Namen, starke Namen sind jedoch nicht erforderlich. Die Verwendung dieses Attributs entspricht dem Laden einer Assembly mit der Load-Methode in .NET Framework. Sie können dieses Attribut nicht verwenden, wenn das AssemblyFile-Attribut verwendet wird. |
AssemblyFile |
Entweder das AssemblyName-Attribut oder das AssemblyFile-Attribut ist erforderlich. Der Dateipfad der Assembly. Dieses Attribut akzeptiert sowohl vollständige als auch relative Pfade. Relative Pfade sind relativ zum Verzeichnis der Projekt- oder Zieldatei, in der das UsingTask-Element deklariert ist. Die Verwendung dieses Attributs entspricht dem Laden einer Assembly mit der LoadFrom-Methode in .NET Framework. Sie können dieses Attribut nicht verwenden, wenn das AssemblyName-Attribut verwendet wird. |
TaskFactory |
Optionales Attribut. Gibt die Klasse in der Assembly an, die für das Generieren von Instanzen des angegebenen Task-Namens zuständig ist. Der Benutzer kann auch einen TaskBody als untergeordnetes Element angeben, das die Aufgabenfactory empfängt und verwendet, um die Aufgabe zu generieren. Der Inhalt von TaskBody ist spezifisch für die Aufgabenfactory. |
TaskName |
Erforderliches Attribut. Der Name der Aufgabe, auf die von einer Assembly verwiesen werden soll. Wenn Mehrdeutigkeiten möglich sind, sollten mit diesem Attribut immer vollständige Namespaces angegeben werden. Liegen Mehrdeutigkeiten vor, wählt MSBuild willkürlich eine Übereinstimmung aus, was zu unerwarteten Ergebnissen führen kann. |
Condition |
Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen finden Sie unter MSBuild-Bedingungen. |
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
Die Gruppe von Parametern, die für den Vorgang angezeigt werden, der durch die angegebene TaskFactory generiert wird. |
|
Die Daten, die an die TaskFactory übergeben werden, um die eine Instanz der Aufgabe zu generieren. |
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
Erforderliches Stammelement einer MSBuild-Projektdatei. |
Hinweise
Auf Umgebungsvariablen, Befehlszeileneigenschaften und Eigenschaften auf Projektebene kann an beliebiger Stelle im UsingTask-Element verwiesen werden, sofern es entweder explizit in der Projektdatei oder in einer importierten Projektdatei angegeben ist. Weitere Informationen finden Sie unter MSBuild-Aufgaben.
Hinweis
Eigenschaften auf Projektebene besitzen keine Bedeutung, wenn das UsingTask-Element aus einer der TASKS-Dateien stammt, die global beim MSBuild-Modul registriert sind.Eigenschaften auf Projektebene sind in MSBuild nicht global.
In MSBuild 4.0 können Using-Aufgaben aus .overridetask-Dateien geladen werden.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie das UsingTask-Element mit einem AssemblyName-Attribut verwendet wird.
<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>
Im folgenden Beispiel wird veranschaulicht, wie das UsingTask-Element mit einem AssemblyFile-Attribut verwendet wird.
<UsingTask TaskName="Email"
AssemblyFile="c:\myTasks\myTask.dll" />
Siehe auch
Konzepte
Referenz zum MSBuild-Projektdateischema