Exception.Message Özellik

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Exception.cs

Geçerli özel durumu açıklayan bir ileti alır.

C#

public virtual string Message { get; }

Özellik Değeri

String

Özel durumun nedenini veya boş bir dizeyi ("") açıklayan hata iletisi.

Örnekler

Aşağıdaki kod örneği bir Exception özel durum oluşturup yakalar ve özelliğini kullanarak Message özel durumun kısa iletisini görüntüler.

C#

// Example for the Exception.HelpLink, Exception.Source,
// Exception.StackTrace, and Exception.TargetSite properties.
using System;

namespace NDP_UE_CS
{
    // Derive an exception; the constructor sets the HelpLink and
    // Source properties.
    class LogTableOverflowException : Exception
    {
        const string overflowMessage = "The log table has overflowed.";

        public LogTableOverflowException(
            string auxMessage, Exception inner ) :
                base( String.Format( "{0} - {1}",
                    overflowMessage, auxMessage ), inner )
        {
            this.HelpLink = "https://learn.microsoft.com";
            this.Source = "Exception_Class_Samples";
        }
    }

    class LogTable
    {
        public LogTable( int numElements )
        {
            logArea = new string[ numElements ];
            elemInUse = 0;
        }

        protected string[ ] logArea;
        protected int       elemInUse;

        // The AddRecord method throws a derived exception if
        // the array bounds exception is caught.
        public    int       AddRecord( string newRecord )
        {
            try
            {
                logArea[ elemInUse ] = newRecord;
                return elemInUse++;
            }
            catch( Exception e )
            {
                throw new LogTableOverflowException(
                    String.Format( "Record \"{0}\" was not logged.",
                        newRecord ), e );
            }
        }
    }

    class OverflowDemo
    {
        // Create a log table and force an overflow.
        public static void Main()
        {
            LogTable log = new LogTable( 4 );

            Console.WriteLine(
                "This example of \n   Exception.Message, \n" +
                "   Exception.HelpLink, \n   Exception.Source, \n" +
                "   Exception.StackTrace, and \n   Exception." +
                "TargetSite \ngenerates the following output." );

            try
            {
                for( int count = 1; ; count++ )
                {
                    log.AddRecord(
                        String.Format(
                            "Log record number {0}", count ) );
                }
            }
            catch( Exception ex )
            {
                Console.WriteLine( "\nMessage ---\n{0}", ex.Message );
                Console.WriteLine(
                    "\nHelpLink ---\n{0}", ex.HelpLink );
                Console.WriteLine( "\nSource ---\n{0}", ex.Source );
                Console.WriteLine(
                    "\nStackTrace ---\n{0}", ex.StackTrace );
                Console.WriteLine(
                    "\nTargetSite ---\n{0}", ex.TargetSite );
            }
        }
    }
}

/*
This example of
   Exception.Message,
   Exception.HelpLink,
   Exception.Source,
   Exception.StackTrace, and
   Exception.TargetSite
generates the following output.

Message ---
The log table has overflowed. - Record "Log record number 5" was not logged.

HelpLink ---
https://learn.microsoft.com

Source ---
Exception_Class_Samples

StackTrace ---
   at NDP_UE_CS.LogTable.AddRecord(String newRecord)
   at NDP_UE_CS.OverflowDemo.Main()

TargetSite ---
Int32 AddRecord(System.String)
*/

Açıklamalar

Hata iletileri özel durumu işleyen geliştiriciyi hedefler. özelliğinin Message metni hatayı tamamen açıklamalı ve mümkün olduğunda hatanın nasıl düzeltilmesi gerektiğini de açıklamalıdır. Üst düzey özel durum işleyicileri iletiyi son kullanıcılara gösterebilir, bu nedenle iletinin dil bilgisi açısından doğru olduğundan ve iletinin her cümlesinin noktayla bitdiğinden emin olmanız gerekir. Soru işaretlerini veya ünlem işaretlerini kullanmayın. Uygulamanız yerelleştirilmiş özel durum iletileri kullanıyorsa, bunların doğru çevrildiğinden emin olmanız gerekir.

Önemli

Özel durum iletilerinde uygun izinleri denetlemeden hassas bilgileri açıklamayın.

özelliğinin Message değeri tarafından ToStringdöndürülen bilgilere eklenir. Message özelliği yalnızca oluşturulurken Exceptionayarlanır. Geçerli örnek için oluşturucuya hiçbir ileti sağlanmadıysa, sistem geçerli sistem kültürü kullanılarak biçimlendirilmiş bir varsayılan ileti sağlar.

Devralanlara Notlar

özelliği Message , ileti içeriği veya biçimi üzerinde denetim gerektiren sınıflarda geçersiz kılınmış. Uygulama kodu genellikle yakalanan bir özel durumla ilgili bilgileri görüntülemesi gerektiğinde bu özelliğe erişir.

Hata iletisi yerelleştirilmiş olmalıdır.

Şunlara uygulanır