Handled Property
Collapse the table of content
Expand the table of content

ApplicationUnhandledExceptionEventArgs.Handled Property


Gets or sets a value that indicates whether the exception is handled.

Namespace:  System.Windows
Assembly:  System.Windows (in System.Windows.dll)

public bool Handled { get; set; }

Property Value

Type: System.Boolean
true to mark the exception as handled, which indicates that Silverlight should not process it further; otherwise, false.

An unhandled exception, where Handled remains false upon exiting the UnhandledException handler, will be passed on to the unmanaged Silverlight event reporting mechanism, where applications can process it as an error through any registered OnError (Silverlight Plug-in Object) handler.

The following example shows how to handle and use the UnhandledException event.

using System.IO; // FileNotFoundException
using System.Windows; // Application, StartupEventArgs, ApplicationUnhandledExceptionEventArgs

namespace SilverlightApplication
    public partial class App : Application
        public App()
            this.Startup += this.Application_Startup;
            this.UnhandledException += this.Application_UnhandledException;


        private void Application_Startup(object sender, StartupEventArgs e)
            this.RootVisual = new Page();

        private void Application_UnhandledException(object sender, 
            ApplicationUnhandledExceptionEventArgs e)
            if (e.ExceptionObject is FileNotFoundException)
                // Inform the user

                // Recover from the error
                e.Handled = true;

            // Exception is unrecoverable so stop the application and allow the 
            // Silverlight plug-in control to detect and process the exception.


Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

© 2015 Microsoft