Exception.Message 속성

정의

현재 예외를 설명하는 메시지를 가져옵니다.

public virtual string Message { get; }

속성 값

예외의 원인을 설명하는 오류 메시지이거나 빈 문자열("")입니다.

구현

예제

다음 코드 예제를 throw 하 고 예외를 Exception catch 하 고 사용 하 여 예외의 문자 메시지를 표시 합니다 Message 속성입니다.

// 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)
*/

설명

오류 메시지는 예외를 처리하는 개발자를 대상으로 합니다. 속성의 Message 텍스트는 오류를 완전히 설명해야 하며 가능한 경우 오류를 수정하는 방법도 설명해야 합니다. 최상위 예외 처리기는 최종 사용자에게 메시지를 표시할 수 있으므로 문법적으로 올바르고 메시지의 각 문장이 마침표로 끝나는지 확인해야 합니다. 물음표나 느낌표를 사용하지 마세요. 애플리케이션에서 지역화 된 예외 메시지를 사용 하는 경우 정확 하 게 변환 하는 것이 해야 합니다.

중요

적절한 권한을 확인하지 않고 예외 메시지에 중요한 정보를 공개하지 마세요.

속성 값 Message 은 에서 반환 ToString하는 정보에 포함됩니다. 속성은 Message 를 만들 때만 설정됩니다 Exception. 현재 instance 대한 생성자에 메시지가 제공되지 않은 경우 시스템은 현재 시스템 문화권을 사용하여 형식이 지정된 기본 메시지를 제공합니다.

상속자 참고

속성은 Message 메시지 콘텐츠 또는 형식을 제어해야 하는 클래스에서 재정의됩니다. 일반적으로 애플리케이션 코드는 예외 발생 했습니다에 대 한 정보를 표시 해야 할 경우이 속성을 액세스 합니다.

오류 메시지는 지역화되어야 합니다.

적용 대상

제품 버전
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0