Byla tato stránka užitečná?
Váš názor na tento obsah je důležitý. Sdělte nám, co si myslíte.
Další podněty?
Zbývající počet znaků: 1500
Message – vlastnost
Tento článek byl přeložen strojově počítačem. Původní text zobrazíte přesunutím ukazatele myši nad jednotlivé věty článku. Další informace
Překlad
Originál

Exception.Message – vlastnost

Získá zprávu popisující aktuální výjimku.

Obor názvů:  System
Sestavení:  mscorlib (v mscorlib.dll)

public virtual string Message { get; }

Hodnota vlastnosti

Typ: System.String
Chybovou zprávu, která vysvětluje důvod výjimku nebo prázdný řetězec ("").

Implementuje

_Exception.Message

Chybové zprávy Cíl vývojář, který zpracovává výjimku. Text Message vlastnost měla úplně popsat chybu a pokud je to možné, by měly rovněž vysvětleno, jak opravit chybu. Obslužné rutiny výjimek nejvyšší úrovně může zobrazit zprávu koncovým uživatelům, měli byste zajistit, že je gramaticky správné a že jednotlivé věty zprávy končí tečkou. Nepoužívejte otazník a vykřičník. Pokud vaše aplikace používá zprávy lokalizovaných výjimek, ujistěte se, že jsou přesně přeložit.

Poznámka k zabezpečeníPoznámka k zabezpečení

Bez příslušných oprávnění kontroly neodkrývají citlivé informace ve zprávách výjimek.

Hodnota Message vlastnost je součástí informace vrácené ToString.Message Pouze při vytváření vlastnost nastavena Exception. Pokud byl pro aktuální instanci konstruktoru žádná zpráva, systém poskytuje výchozí zprávu, která je zformátován s použitím aktuální jazykové verze systému.

Windows Runtime a.NET Framework 4.5.1

Začínající .NET Framework 4.5.1 a Windows 8.1, lepší věrnost chybové zprávy z výjimky, které jsou šířeny z Windows Runtime typy a členy, které nejsou součástí rozhraní.NET Framework. Zprávy, zejména výjimky rozšíření komponentu Visual C++ (C + +/ CX) jsou nyní šířeny zpět do rozhraní.NET Framework Exception objekty.

Poznámky pro implementátory

Pokud vyvolat výjimku z vlastnosti a potřebujete odkazovat v textu Message argumentu vlastnost nastavit nebo načíst, použít jako argument pro vlastnost název "hodnota".

Poznámky pro dědice

Message Vlastnost je přepsána tříd, které vyžadují kontrolu nad obsahem zpráv nebo formát. Kód aplikace obvykle poskytuje přístup k této vlastnosti při potřebuje k zobrazení informací o výjimku, kterou byl zachycen.

Chybová zpráva musí být lokalizována.

Následující příklad kódu vyvolá a poté zachytí Exceptionvýjimku a zobrazí text výjimky zpráva Message vlastnost.


// 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 = "http://msdn.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 ---
http://msdn.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)
*/


.NET Framework

Podporováno v: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Podporováno v: 4, 3.5 SP1

Knihovny přenosných tříd

Podporováno v: Knihovny přenosných tříd

.NET pro aplikace pro Windows Store

Podporováno v: Windows 8

.NET pro aplikace pro Windows Phone

Podporováno v: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (role Server Core není podporována), Windows Server 2008 R2 (role Server Core je podporována s aktualizací SP1 nebo novější, architektura Itanium není podporována)

.NET Framework nepodporuje některé verze platforem. Seznam podporovaných verzí naleznete v tématu .NET – požadavky na systém.

Obsah vytvořený komunitou

Přidat
Zobrazit:
© 2015 Microsoft