Aracılığıyla paylaş

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

Uyarı

Özelliklerden ve öğelerden farklı olarak, için geçerli olan ilkUsingTask öğe kullanılır; görevleri geçersiz kılmak için TaskName var olandan UsingTask yeni bir tanımlamanız veya yeni Override="true"öğesinde belirtmeniz UsingTask gerekir.

Öznitelikler ve öğeler

Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.

Attributes

Özellik Description
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 konağı işleminde çalışır.

Desteklenen değerler şunlardır x86 : (32 bit), x64 (64 bit), CurrentArchitectureve * (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 altında çalışması gereken çalışma zamanını belirtir. Geçerli MSBuild işlemi gereksinimi karşılamıyorsa, görev bunu sağlayan bir görev konağı işleminde çalışır.

Desteklenen değerler şunlardır CLR2 : (.NET Framework 3.5), CLR4 (.NET Framework 4.7.2 veya üzeri), CurrentRuntime, NET (.NET) ve * (herhangi bir çalışma zamanı). Runtime="NET" MSBuild 18.0'dan (.NET SDK 10/Visual Studio 2026) başlayarak desteklenir ve şu anda yalnızca kullanan Microsoft.NET.Sdkprojeler için desteklenir. dotnet build (MSBuild'in .NET sürümü) görevleri çalıştıramaz CLR2/CLR4 .
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 öğeler

Öğe Description
ParameterGroup Belirtilen TaskFactorytarafı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 Description
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.

Uyarı

Öğe, MSBuild altyapısına genel olarak kaydedilmiş UsingTask dosyalarından birinden geliyorsa, 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ı dosyalardan .overridetask 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ıştırılan çalışma zamanı 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>

Ayrıca bakınız

  • Last updated on