Hata görevi

  • Makale

Derlemeyi durdurur ve değerlendirilen koşullu deyime göre bir hata kaydeder.

Parametreler

Aşağıdaki tabloda görevin parametreleri Error açıklanmaktadır.

Parametre Tanım
Code İsteğe bağlı String parametre.

Hatayla ilişkilendirilecek hata kodu.
File İsteğe bağlı String parametre.

Hatayı içeren dosyanın adı. Hiçbir dosya adı sağlanmadıysa, Hata görevini içeren dosya kullanılır.
HelpKeyword İsteğe bağlı String parametre.

Hatayla ilişkilendirilecek yardım anahtar sözcüğü. Yalnızca dahili kullanım içindir.
HelpLink İsteğe bağlı String parametre.

Hata hakkında daha fazla bilgi için bir bağlantı.
Text İsteğe bağlı String parametre.

Parametre olarak değerlendirilirse MSBuild tarafından günlüğe truealınan Condition hata metni.

Açıklamalar

Bu görev, Error MSBuild projelerinin günlüğe kaydedilenlere hata metni vermesine ve derleme yürütmeyi durdurmasına olanak tanır.

Condition parametresi olarak değerlendirilirse truederleme durdurulur ve bir hata günlüğe kaydedilir. Parametre Condition yoksa hata günlüğe kaydedilir ve derleme yürütme durdurulur. Günlüğe kaydetme hakkında daha fazla bilgi için bkz . Derleme günlüklerini alma.

Yukarıda listelenen parametrelere ek olarak, bu görev kendi sınıfından TaskExtension devralan sınıfından Task parametreleri devralır. Bu ek parametrelerin ve açıklamalarının listesi için bkz . TaskExtension temel sınıfı.

HelpKeyword Visual Studio tarafından bağlamsal yardım özelliğini (F1) desteklemek için kullanılır. Çevrimiçi yardım sayfasını bir hata iletisiyle ilişkilendirmek için kullanabilirsiniz HelpLink .

Örnek

Aşağıdaki kod örneği tüm gerekli özelliklerin ayarlandığını doğrular. Bunlar ayarlanmamışsa, proje bir hata olayı oluşturur ve görevin parametresinin Text değerini günlüğe Error kaydeder.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="ValidateCommandLine">
        <Error
            Text=" The 0 property must be set on the command line."
            Condition="'$(0)' == ''" />
        <Error
            Text="The FREEBUILD property must be set on the command line."
            Condition="'$(FREEBUILD)' == ''" />
    </Target>
    ...
</Project>

Ayrıca bkz.