Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ApplicationUnhandledExceptionEventArgs Class

Provides data for the Application.UnhandledException event.

System.Object
  System.EventArgs
    System.Windows.ApplicationUnhandledExceptionEventArgs

Namespace:  System.Windows
Assembly:  System.Windows (in System.Windows.dll)
public class ApplicationUnhandledExceptionEventArgs : EventArgs

The ApplicationUnhandledExceptionEventArgs type exposes the following members.

  NameDescription
Public methodSupported by Silverlight for Windows PhoneApplicationUnhandledExceptionEventArgsInitializes a new instance of the ApplicationUnhandledExceptionEventArgs class.
Top
  NameDescription
Public propertySupported by Silverlight for Windows PhoneExceptionObjectGets or sets the unhandled exception.
Public propertySupported by Silverlight for Windows PhoneHandledGets or sets a value that indicates whether the exception is handled.
Top
  NameDescription
Public methodSupported by Silverlight for Windows PhoneEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows PhoneFinalizeAllows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows PhoneMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneToStringReturns a string that represents the current object. (Inherited from Object.)
Top

Application.UnhandledException uses the generic EventHandler<TEventArgs> and this ApplicationUnhandledExceptionEventArgs class for event data.

The ExceptionObject property provides information about the unhandled exception. Set the Handled property to true to prevent additional processing of the exception after your UnhandledException handler completes.

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;

            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.
        }
    }
}


Silverlight

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.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft. All rights reserved.