UsingTask öğesi (MSBuild)
Görev öğesinde başvuruda bulunılan görevi, görev uygulamasını içeren derlemeye eşler.
<UsingTask Projesi><>
Sözdizimi
<UsingTask TaskName="TaskName"
AssemblyName = "AssemblyName"
TaskFactory = "ClassName"
Condition="'String A'=='String B'" />
Not
Özelliklerden ve öğelerden farklı olarak, için geçerli olan ilk UsingTask
öğe kullanılır; görevleri geçersiz kılmak için TaskName
var olandan önce yeni UsingTask
bir tanımlamanız veya yeni UsingTask
öğesinde belirtmeniz Override="true"
gerekir.
Öznitelikler ve öğeler
Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.
Özellikler
Öznitelik | Açıklama |
---|---|
Architecture |
İsteğe bağlı öznitelik. Görevin belirtilen bitlik işleminde çalıştırılması gerektiğini belirtir. Geçerli işlem gereksinimi karşılamıyorsa, görev bunu yerine getiren bir görev ana bilgisayar işleminde çalıştırılır. Desteklenen değerler şunlardır x86 : (32 bit), x64 (64 bit), CurrentArchitecture ve * (herhangi bir mimari). |
AssemblyName |
AssemblyName Özniteliği veya AssemblyFile özniteliği gereklidir.Yüklenecek derlemenin adı. AssemblyName özniteliği, tanımlayıcı adlandırma gerekli olmasa da, tanımlayıcı adlandırılmış derlemeleri kabul eder. Bu özniteliğin kullanılması, .NET'te yöntemini kullanarak bir derlemenin yüklenmesiyle Load eşdeğerdir.Öznitelik kullanılıyorsa AssemblyFile bu özniteliği kullanamazsınız. |
AssemblyFile |
AssemblyName veya AssemblyFile özniteliği gereklidir.Derlemenin dosya yolu. Bu öznitelik tam yolları veya göreli yolları kabul eder. Göreli yollar, öğenin bildirildiği proje dosyasının veya hedef dosyasının dizinine UsingTask göredir. Bu özniteliğin kullanılması, .NET'te yöntemini kullanarak bir derlemenin yüklenmesiyle LoadFrom eşdeğerdir.Öznitelik kullanılıyorsa AssemblyName bu özniteliği kullanamazsınız. |
Override |
İsteğe bağlı öznitelik. Bu UsingTask öğenin aynı görev adını tanımlayan diğer öğelerden daha yüksek öncelikli olması gerektiğini belirtir. Görev adı başına yalnızca bir geçersiz kılmaya izin verilir. MSBuild 17.2'de eklendi. |
Runtime |
İsteğe bağlı öznitelik. Görevin belirtilen sürümün .NET Framework çalışma zamanında çalıştırılması gerektiğini belirtir. Geçerli işlem gereksinimi karşılamıyorsa, görev bunu yerine getiren bir görev ana bilgisayar işleminde çalıştırılır. Desteklenen değerler : 'NET' (.NET Core ve .NET 5 veya üzeri), CLR2 (.NET Framework 3.5), CLR4 (.NET Framework 4.7.2 veya üzeri), CurrentRuntime ve * (herhangi bir çalışma zamanı). .NET Framework (CLR4) MSBuild'i çalıştırırken NET görevlerini çağıramazsınız ve .NET MSBuild'den CLR2/CLR4 görevlerini çağıramazsınız (çalıştırırken dotnet build ). |
TaskFactory |
İsteğe bağlı öznitelik. Derlemede belirtilen Task adın örneklerini oluşturmakla sorumlu olan sınıfını belirtir. Kullanıcı, görev fabrikasının aldığı ve görevi oluşturmak için kullandığı bir alt öğe olarak da belirtebilir Task . öğesinin Task içeriği görev fabrikasına özeldir. Varsayılan değer TaskFactory , görevi çalışan işleme yükleyen değeridir AssemblyTaskFactory . |
TaskName |
Gerekli öznitelik. Derlemeden başvurulacak görevin adı. Belirsizlikler mümkünse, bu öznitelik her zaman tam ad alanları belirtmelidir. Belirsizlikler varsa, MSBuild beklenmeyen sonuçlara neden olabilecek rastgele bir eşleşme seçer. |
Condition |
İsteğe bağlı öznitelik. Değerlendirilecek koşul. Daha fazla bilgi için bkz . Koşullar. |
Alt öğeleri
Öğe | Açıklama |
---|---|
ParameterGroup | Belirtilen TaskFactory tarafından oluşturulan görevde görünen parametre kümesi. |
Görev | Görevin bir örneğini oluşturmak için öğesine geçirilen TaskFactory veriler. |
Üst öğeler
Öğe | Açıklama |
---|---|
Proje | MSBuild proje dosyasının gerekli kök öğesi. |
Açıklamalar
Ortam değişkenlerine, komut satırı özelliklerine, proje düzeyi özelliklerine ve proje düzeyi öğelerine doğrudan veya içeri aktarılan bir proje dosyası aracılığıyla proje dosyasına dahil edilen öğelerde başvurulabilir UsingTask
. Daha fazla bilgi için bkz . Görevler.
Not
Öğe, MSBuild altyapısına genel olarak kaydedilmiş .tasks dosyalarından birinden geliyorsaUsingTask
, proje düzeyi özelliklerin ve öğelerin bir anlamı yoktur. Proje düzeyi değerleri MSBuild için genel değildir.
MSBuild 4.0'da, görevlerin kullanılması .overridetask dosyalarından yüklenebilir.
özel görevi içeren derleme ilk kullanıldığında yüklenir Task
.
Örnek 1
Aşağıdaki örnekte, öğesinin UsingTask
bir AssemblyFile
öznitelikle nasıl kullanılacağı gösterilmektedir.
<UsingTask TaskName="Email"
AssemblyFile="c:\myTasks\myTask.dll" />
Yok Runtime
veya TaskHost
belirtilmediğinden, görev MSBuild işleminde, belirli bir derleme için çalışıyor olan çalışma zamanında ve mimaride yürütülür.
Örnek 2
Aşağıdaki örnekte, öğesinin UsingTask
bir AssemblyName
öznitelik ve bu derlemede tanımlanmış bir özel TaskFactory
öğe ile nasıl kullanılacağı gösterilmektedir.
<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>