Element UsingTask (MSBuild)
Mapuje zadanie, do którego odwołują się zadania elementu zestawu zawierającego wykonania zadania.
<UsingTask TaskName="TaskName"
AssemblyName = "AssemblyName"
TaskFactory = "ClassName"
Condition="'String A'=='String B'" />
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.
Atrybuty
Atrybut |
Opis |
|---|---|
AssemblyName |
Albo AssemblyName atrybutu lub AssemblyFile atrybut jest wymagany. Nazwa zestawu do załadowania.AssemblyName Atrybut akceptuje zestawy o silnych nazwach, chociaż silnych nazw nie jest wymagane.Za pomocą tego atrybutu jest równoważne ładowania zestawu przy użyciu Load metodę w .NET Framework. Ten atrybut nie można używać, jeśli AssemblyFile atrybut jest używany. |
AssemblyFile |
Albo AssemblyName lub AssemblyFile atrybut jest wymagany. Ścieżka pliku zestawu.Ten atrybut akceptuje pełne ścieżki lub ścieżki względne.Ścieżki względne są względne wobec katalogu pliku projektu lub pliku cele gdzie UsingTask element jest zadeklarowany.Za pomocą tego atrybutu jest równoważne ładowania zestawu przy użyciu LoadFrom metodę w .NET Framework. Ten atrybut nie można używać, jeśli AssemblyName atrybut jest używany. |
TaskFactory |
Atrybut opcjonalny. Określa klasę w zestawie, który jest odpowiedzialny za wygenerowanie wystąpień określonego Task nazwy. Użytkownik może również określić TaskBody jako element podrzędny, który factory zadania odbiera i używa do wygenerowania tego zadania.Zawartość TaskBody są specyficzne dla fabryki zadania. |
TaskName |
Wymagany atrybut. Nazwa zadania, aby odwołać się od zestawu.Możliwe są niejasności, ten atrybut należy zawsze określić pełną obszarów nazw.Jeśli istnieją niejasności, MSBuild wybiera dowolnego dopasowania, która może dawać nieoczekiwane wyniki. |
Condition |
Atrybut opcjonalny. Warunek do oceny.Aby uzyskać więcej informacji, zobacz Program MSBuild warunki. |
Elementy podrzędne
Element |
Opis |
|---|---|
Zestaw parametrów, które pojawiają się na zadania, który jest generowany przez określony TaskFactory. |
|
Dane, które są przekazywane do TaskFactory do generowania wystąpienie zadania. |
Elementy nadrzędne
Element |
Opis |
|---|---|
Element główny wymagane MSBuild pliku projektu. |
Uwagi
Zmienne środowiskowe, właściwości wiersza polecenia i właściwości na poziomie projektu można odwoływać się gdziekolwiek w UsingTask element występuje w pliku projektu jawnie lub za pośrednictwem zaimportowanego pliku projektu.Aby uzyskać więcej informacji, zobacz Program MSBuild zadań.
[!UWAGA]
Właściwości na poziomie projektu mają żadnego znaczenia, jeśli UsingTask element pochodzi z jednego z plików .tasks, które są globalnie zarejestrowane z MSBuild silnika.Właściwości na poziomie projektu nie są globalne MSBuild.
W MSBuild 4.0, za pomocą zadań mogą być ładowane z plików .overridetask.
Przykład
Poniższy przykład pokazuje, jak używać UsingTask element z AssemblyName atrybut.
<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>
Poniższy przykład pokazuje, jak używać UsingTask element z AssemblyFile atrybut.
<UsingTask TaskName="Email"
AssemblyFile="c:\myTasks\myTask.dll" />
Zobacz też
Koncepcje
Odwołanie do projektu programu MSBuild pliku schematu