Target 'ın görev öğesi (MSBuild)

MSBuild görevinin bir örneğini oluşturur ve yürütür. Öğe adı, oluşturulmakta olan görevin adıyla belirlenir.

<Proje><Hedefi>

Syntax

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Öznitelikler ve öğeler

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

Öznitelikler

Öznitelik Açıklama
Condition İsteğe bağlı öznitelik. Değerlendirilecek koşul. Daha fazla bilgi için bkz . Koşullar.
ContinueOnError İsteğe bağlı öznitelik. Aşağıdaki değerlerden birini içerebilir:

- WarnAndContinue veya true. Bir görev başarısız olduğunda, Target öğesindeki ve derlemedeki sonraki görevler yürütülmeye devam eder ve görevdeki tüm hatalar uyarı olarak değerlendirilir.
- ErrorAndContinue. Bir görev başarısız olduğunda, öğesindeki ve derlemedeki Target sonraki görevler yürütülmeye devam edilir ve görevdeki tüm hatalar hata olarak değerlendirilir.
- ErrorAndStop veya false (varsayılan). Bir görev başarısız olduğunda, öğesindeki ve derlemedeki Target kalan görevler yürütülür ve öğenin tamamı Target ile derlemenin başarısız olduğu kabul edilir.

.NET Framework'ün 4.5 öncesi sürümleri yalnızca true ve false değerlerini desteklemektedir.

Daha fazla bilgi için bkz . Nasıl yapılır: Görevlerdeki hataları yoksayma.
Parameter Görev sınıfı özniteliğiyle [Required] etiketlenmiş bir veya daha fazla özellik içeriyorsa gereklidir.

Parametre değerini değeri olarak içeren kullanıcı tanımlı görev parametresi. öğesinde, her öznitelik görev sınıfındaki Task bir .NET özelliğine eşlenecek şekilde herhangi bir sayıda parametre olabilir.

Alt öğeleri

Öğe Açıklama
Çıkış Görevin çıkışlarını proje dosyasında depolar. Bir görevde sıfır veya daha fazla Output öğe olabilir.

Üst öğeler

Öğe Açıklama
Hedef MSBuild görevleri için kapsayıcı öğesi.

Açıklamalar

Task MSBuild proje dosyasındaki bir öğe bir görevin örneğini oluşturur, üzerinde özellikleri ayarlar ve yürütür. öğesi çıkış Output parametrelerini proje dosyasının başka bir yerinde kullanılacak özelliklerde veya öğelerde depolar.

Bir görevin üst Target öğesinde OnError öğeleri varsa, görev başarısız olursa ve ContinueOnError değerine falsesahipse bunlar yine de değerlendirilir. Görevler hakkında daha fazla bilgi için bkz. Görevler.

Örnek

Aşağıdaki kod örneği , Csc görev sınıfının bir örneğini oluşturur, özelliklerin altısını ayarlar ve görevi yürütür. Yürütmeden sonra, nesnesinin özelliğinin OutputAssembly değeri adlı FinalAssemblyNameöğe listesine yerleştirilir.

<Target Name="Compile" DependsOnTarget="Resources" >
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

Ayrıca bkz.