UsingTask öğesi (MSBuild)

Makale
02/26/2013

Başvurulan görev eşleştiren bir görev görev uygulaması içeren derleme öğesi.

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

Öznitelikler ve Öğeler

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

Öznitelikler

Öznitelik	Description
AssemblyName	Ya da AssemblyName özniteliği veya AssemblyFile özniteliği gereklidir. Yüklemek için derleme adı.AssemblyName Özniteliği adlandırma güçlü gerekli olmamasına karşın derlemeler kesin adlandırılmış, kabul.Bu özniteliği kullanarak bir derlemenin yüklenmesi için eşdeğer Load yönteminde .NET Framework. Bu öznitelik, kullanamaz AssemblyFile özniteliği kullanılır.
AssemblyFile	Ya da AssemblyName veya AssemblyFile özniteliği gereklidir. Derlemenin dosya yolu.Bu öznitelik, tam yol ya da göreli yolları kabul eder.Göreli yollardır proje dosyası veya hedef dosyanın dizine göre nerede UsingTask öğesi bildiriliyor.Bu özniteliği kullanarak bir derlemenin yüklenmesi için eşdeğer LoadFrom yönteminde .NET Framework. Bu öznitelik, kullanamaz AssemblyName özniteliği kullanılır.
TaskFactory	İsteğe bağlı öznitelik. Sınıfın örneklerini belirtilen oluşturmaktan sorumlu derleme belirtir Task adı. Kullanıcı ayrıca belirtebilir bir TaskBody görev Fabrika alır ve görev oluşturmak için kullandığı bir alt öğesi olarak.İçeriğini TaskBody görev Fabrika özgüdür.
TaskName	Gerekli öznitelik. Bir derleme başvurusu yapmak için görev adı.Bu öznitelik ambiguities mümkün olması durumunda, tam ad alanları her zaman belirtmeniz gerekir.Ambiguities, MSBuild beklenmeyen sonuçlar rasgele bir eşleşme seçer.
Condition	İsteğe bağlı öznitelik. Değerlendirmek için koşul.Daha fazla bilgi için bkz. MSBuild koşulları.

Alt Öğeler

Öge	Description
ParameterGroup	Oluşturulan görev görünür parametre kümesi tarafından belirtilen TaskFactory.
TaskBody	İçin geçirilen veri TaskFactory görev örneğini oluşturmak için.

Üst Öğeler

Öge	Description
Proje	Gerekli kök öğesi bir MSBuild proje dosyası.

Notlar

Ortam değişkenleri, komut satırı özellikleri ve proje düzeyinde özellikler içinde herhangi bir yerde başvurulabilir UsingTask proje dosyasında açıkça veya alınan proje dosyası aracılığıyla görünüyorsa, öğe.Daha fazla bilgi için bkz. MSBuild görevleri.

[!NOT]

Proje düzeyi özelliklerine sahip hiçbir anlamı, UsingTask ile genel olarak kayıtlı .tasks dosyaları birinden öğesi gelmeye MSBuild altyapısı.Proje düzeyi özellikleri için genel değil MSBuild.

De MSBuild 4.0, görevleri'ni kullanarak yüklenmiş dosyaları .overridetask.

Örnek

Aşağıdaki örnek, nasıl kullanılacağını gösterir UsingTask öğe ile bir AssemblyName özniteliği.

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

Aşağıdaki örnek, nasıl kullanılacağını gösterir UsingTask öğe ile bir AssemblyFile özniteliği.

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

Ayrıca bkz.

Kavramlar

MSBuild görevleri

MSBuild proje dosyası Şeması Başvurusu

Diğer Kaynaklar

MSBuild görevi başvurusu

Aracılığıyla paylaş