ApplicationUnhandledExceptionEventArgs.ExceptionObject Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets the unhandled exception.

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

Syntax

'Declaration
Public Property ExceptionObject As Exception
public Exception ExceptionObject { get; set; }

Property Value

Type: System.Exception
The unhandled exception.

Remarks

This property is read-write in the object model, but your application code would not typically write to it. The property is intended to report the conditions of an error that is raised by Silverlight.

Examples

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

Imports System.IO

Partial Public Class App
    Inherits Application

    Public Sub New()
        InitializeComponent()
    End Sub

    Private Sub Application_Startup(ByVal o As Object, _
        ByVal e As StartupEventArgs) Handles Me.Startup

        Me.RootVisual = New Page()

    End Sub

    Private Sub Application_UnhandledException(ByVal sender As Object, _
        ByVal e As ApplicationUnhandledExceptionEventArgs) Handles Me.UnhandledException

        If TypeOf e.ExceptionObject Is FileNotFoundException Then
            ' Inform the user 

            ' Recover from the error 
            e.Handled = True
            Return
        End If

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

    End Sub

End Class
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;

            InitializeComponent();
        }

        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;
                return;
            }

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

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

Platforms

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