UsingTask elem (MSBuild)

A Tevékenység elemben hivatkozott feladatot a feladat implementálását tartalmazó szerelvényhez rendeli.

<Project><UsingTask>

Szemantika

<UsingTask TaskName="TaskName"
    AssemblyName = "AssemblyName"
    TaskFactory = "ClassName"
    Condition="'String A'=='String B'" />

Megjegyzés:

A tulajdonságoktól és elemektől eltérően a rendszer az elsőUsingTask olyan elemet használja, amely a TaskName meglévőre vonatkozik; a feladatok felülbírálásához újat kell definiálnia UsingTask a meglévő előtt, vagy meg kell adnia Override="true" az újatUsingTask.

Attribútumok és elemek

A következő szakaszok az attribútumokat, a gyermekelemeket és a szülőelemeket ismertetik.

Attributes

Attribute	Description
Architecture	Nem kötelező attribútum. Azt határozza meg, hogy a feladatnak a megadott bitállapotú folyamatban kell futnia. Ha az aktuális folyamat nem felel meg a követelménynek, a feladat egy feladatgazdafolyamatban fut, amely igen. A támogatott értékek a x86 következők: (32 bites), x64 (64 bites), CurrentArchitectureés * (bármely architektúra).
AssemblyName	AssemblyName Az attribútum vagy az AssemblyFile attribútum megadása kötelező. A betöltendő szerelvény neve. Az AssemblyName attribútum erős névvel ellátott szerelvényeket fogad el, de az erős elnevezés nem szükséges. Az attribútum használata egyenértékű egy szerelvény betöltésével a Load .NET-ben használt módszerrel. Ezt az attribútumot nem használhatja, ha az AssemblyFile attribútumot használja.
AssemblyFile	Vagy az AssemblyNameAssemblyFile attribútumra van szükség. A szerelvény fájlútvonala. Ez az attribútum teljes elérési utakat vagy relatív elérési utakat fogad el. A relatív elérési utak a projektfájl vagy a célfájl könyvtárához viszonyítva vannak, ahol az UsingTask elem deklarálva van. Az attribútum használata egyenértékű egy szerelvény betöltésével a LoadFrom .NET-ben használt módszerrel. Ezt az attribútumot nem használhatja, ha az AssemblyName attribútumot használja.
Override	Nem kötelező attribútum. Azt határozza meg, hogy ennek az UsingTask elemnek magasabb prioritásúnak kell lennie, mint az azonos tevékenységnevet meghatározó többi elemnek. Tevékenységnévenként csak egy felülbírálás engedélyezett. Hozzáadva az MSBuild 17.2-ben.
Runtime	Nem kötelező attribútum. Megadja, hogy a feladatnak mely futtatókörnyezetben kell futnia. Ha az aktuális MSBuild folyamat nem felel meg a követelménynek, a feladat egy feladatgazdafolyamatban fut, amely igen. A támogatott értékek a CLR2 következők: (.NET Framework 3.5), CLR4 (.NET Framework 4.7.2 vagy újabb), CurrentRuntime, NET (.NET) és * (bármely futtatókörnyezet). Runtime="NET" az MSBuild 18.0 -tól (.NET SDK 10/Visual Studio 2026) támogatott, és jelenleg csak azokat Microsoft.NET.Sdka projekteket támogatja, dotnet build (az MSBuild .NET-verziója) nem tud feladatokat futtatni CLR2/CLR4 .
TaskFactory	Nem kötelező attribútum. Megadja a szerelvény azon osztályát, amely a megadott Task név példányainak létrehozásáért felelős. A felhasználó gyermekelemként is megadhat egy Task elemet, amelyet a feladat-előállító fogad és használ a tevékenység létrehozásához. A tartalom a Task feladat-előállítóra jellemző. Az alapértelmezett TaskFactory érték az AssemblyTaskFactory, amely betölti a feladatot a futó folyamatba.
TaskName	Kötelező attribútum. A szerelvényből hivatkozni kívánt feladat neve. Ha lehetséges kétértelműség, ennek az attribútumnak mindig teljes névtereket kell megadnia. Kétértelműség esetén az MSBuild tetszőleges egyezést választ, amely váratlan eredményeket eredményezhet.
Condition	Nem kötelező attribútum. A kiértékelendő feltétel. További információ: Feltételek.

Gyermekelemek

Elem	Description
ParameterGroup	A megadott TaskFactoryfeladat által létrehozott tevékenységen megjelenő paraméterek halmaza.
tevékenység	A feladat egy példányának létrehozásához átadott TaskFactory adatok.

Szülőelemek

Elem	Description
Projekt	Az MSBuild projektfájl szükséges gyökéreleme.

Megjegyzések

A környezeti változókra, parancssori tulajdonságokra, projektszintű tulajdonságokra és projektszintű elemekre közvetlenül UsingTask vagy importált projektfájlon keresztül hivatkozhat a projektfájl elemeiben. További információ: Feladatok.

Megjegyzés:

A projektszintű tulajdonságoknak és elemeknek nincs értelme, ha az UsingTask elem az MSBuild motorral globálisan regisztrált .tasks fájlok egyikéből származik. A projektszintű értékek nem globálisak az MSBuild számára.

Az MSBuild 4.0-ban a feladatok fájlból .overridetask tölthetők be.

Az egyéni feladatot tartalmazó szerelvény az első használatkor Task lesz betöltve.

1. példa

Az alábbi példa bemutatja, hogyan használhatja az UsingTask elemet attribútummal AssemblyFile .

<UsingTask TaskName="Email"
           AssemblyFile="c:\myTasks\myTask.dll" />

Mivel nincs megadva vagy Runtime nincs TaskHost megadva, a feladat az MSBuild folyamatban, az adott buildhez futó futtatókörnyezetben és architektúrában fut.

2. példa

Az alábbi példa bemutatja, hogyan használhatja az UsingTask elemet egy AssemblyName attribútummal és egy, az adott szerelvényben definiált egyéni TaskFactory beállítással.

<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>
       <Task>
      ... Task factory-specific data ...
       </Task>
</UsingTask>

Lásd még

• Feladatok
• Útmutató: Célok és feladatok konfigurálása
• Tevékenységhivatkozás
• Projektfájl sémahivatkozása