Hedef görev öğesi (MSBuild)

Makale
10/13/2023

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

Sözdizimi

<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	Tanım
`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, Hedef öğ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 `Task` herhangi bir sayıda parametre olabilir ve her öznitelik görev sınıfındaki bir .NET özelliğine eşlenebilir.

Alt öğeleri

Öğe	Tanım
Çıkış	Görevdeki çıkışları proje dosyasında depolar. Bir görevde sıfır veya daha fazla `Output` öğe olabilir.

Üst öğeler

Öğe	Tanım
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, Output çıkış 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>