Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
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"
Condition="'String A'=='String B'" />
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
AssemblyName |
Entweder das AssemblyName-Attribut oder das AssemblyFile-Attribut ist erforderlich. Der Name der zu ladenden Assembly. Das AssemblyName-Attribut akzeptiert zwar Assemblys mit starkem Namen, diese 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 zur 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. |
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 hierzu finden Sie unter MSBuild-Bedingungen. |
Untergeordnete Elemente
Keine
Ü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, vorausgesetzt, es ist explizit oder über eine importierte Projektdatei in der Projektdatei enthalten. Weitere Informationen hierzu finden Sie unter MSBuild-Aufgaben.
Tipp
Eigenschaften auf Projektebene besitzen keine Bedeutung, wenn das UsingTask-Element aus einer der TASKS-Dateien stammt, die global beim MSBuild-Modul registriert sind. Diese Eigenschaften sind nicht global in MSBuild enthalten.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie das UsingTask-Element mit einem AssemblyName-Attribut verwendet wird.
<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
AssemblyName="Microsoft.Build.Tasks" />
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