UsingTask öğesi (MSBuild)

Makale
12/14/2023

Görev öğesinde başvuruda bulunılan görevi, görev uygulamasını içeren derlemeye eşler.

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" />

Hiçbir Runtime veya TaskHost belirtilmemiş olduğundan, görev belirli bir derleme için çalıştırılan çalışma zamanı ve mimaride MSBuild işlemi 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>

Aracılığıyla paylaş