Hedef görev öğesi (MSBuild)
MSBuild görevinin bir örneğini oluşturur ve yürütür. Öğe adı, oluşturulan görevin adıyla belirlenir.
<Proje><Hedefi>
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 false
sahipse 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>