Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Application.ThreadException événement

 

Date de publication : novembre 2016

Se produit lorsqu'une exception de thread ininterrompu est levée.

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

public static event ThreadExceptionEventHandler ThreadException

Cet événement permet à votre application Windows Forms pour gérer sinon non prise en charge des exceptions qui se produisent dans les threads Windows Forms. Attachez vos gestionnaires d’événements pour le ThreadException événements pour traiter ces exceptions, qui laisseront votre application dans un état inconnu. Si possible, les exceptions doivent être gérées par une bloc de gestion structurée des exceptions.

Vous pouvez modifier ce rappel est utilisé pour les exceptions de thread Windows Forms non gérées en définissant SetUnhandledExceptionMode. Pour intercepter les exceptions qui se produisent dans les threads non créés et détenus par les Windows Forms, utilisez le UnhandledException Gestionnaire d’événements.

System_CAPS_noteRemarque

Pour garantir qu’aucune activation de cet événement n’est pas respectées, vous devez joindre un gestionnaire avant d’appeler Application.Run.

System_CAPS_cautionAttention

Comme il s’agit d’un événement statique, vous devez détacher vos gestionnaires d’événements lorsque votre application est supprimée ou entraînent des fuites de mémoire.

L’exemple de code suivant définit des gestionnaires d’événements pour les exceptions qui se produisent sur des threads Windows Forms et les exceptions qui se produisent sur d’autres threads. Il définit SetUnhandledExceptionMode afin que toutes les exceptions sont gérées par l’application, indépendamment des paramètres dans le fichier de configuration de l’application utilisateur. Il utilise le ThreadException événements pour gérer les exceptions de thread d’interface utilisateur et le UnhandledException événements pour gérer les exceptions de thread d’interface utilisateur. Étant donné que UnhandledException ne peut pas empêcher une application de se terminer, l’exemple consigne simplement cette erreur dans le journal des événements avant l’arrêt.

Cet exemple suppose que vous avez défini deux Button contrôles, button1 et button2, sur votre Form classe.

Thread newThread = null;

// Starts the application. 
[SecurityPermission(SecurityAction.Demand, Flags = SecurityPermissionFlag.ControlAppDomain)]
public static void Main(string[] args)
{
    // Add the event handler for handling UI thread exceptions to the event.
    Application.ThreadException += new ThreadExceptionEventHandler(ErrorHandlerForm.Form1_UIThreadException);

    // Set the unhandled exception mode to force all Windows Forms errors to go through
    // our handler.
    Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);

    // Add the event handler for handling non-UI thread exceptions to the event. 
    AppDomain.CurrentDomain.UnhandledException +=
        new UnhandledExceptionEventHandler(CurrentDomain_UnhandledException);

    // Runs the application.
    Application.Run(new ErrorHandlerForm());
}

// Programs the button to throw an exception when clicked.
private void button1_Click(object sender, System.EventArgs e)
{
    throw new ArgumentException("The parameter was invalid");
}

// Start a new thread, separate from Windows Forms, that will throw an exception.
private void button2_Click(object sender, System.EventArgs e)
{
    ThreadStart newThreadStart = new ThreadStart(newThread_Execute);
    newThread = new Thread(newThreadStart);
    newThread.Start();
}

// The thread we start up to demonstrate non-UI exception handling. 
void newThread_Execute()
{
    throw new Exception("The method or operation is not implemented.");
}

// Handle the UI exceptions by showing a dialog box, and asking the user whether
// or not they wish to abort execution.
private static void Form1_UIThreadException(object sender, ThreadExceptionEventArgs t)
{
    DialogResult result = DialogResult.Cancel;
    try
    {
        result = ShowThreadExceptionDialog("Windows Forms Error", t.Exception);
    }
    catch
    {
        try
        {
            MessageBox.Show("Fatal Windows Forms Error",
                "Fatal Windows Forms Error", MessageBoxButtons.AbortRetryIgnore, MessageBoxIcon.Stop);
        }
        finally
        {
            Application.Exit();
        }
    }

    // Exits the program when the user clicks Abort.
    if (result == DialogResult.Abort)
        Application.Exit();
}

// Handle the UI exceptions by showing a dialog box, and asking the user whether
// or not they wish to abort execution.
// NOTE: This exception cannot be kept from terminating the application - it can only 
// log the event, and inform the user about it. 
private static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    try
    {
        Exception ex = (Exception)e.ExceptionObject;
        string errorMsg = "An application error occurred. Please contact the adminstrator " +
            "with the following information:\n\n";

        // Since we can't prevent the app from terminating, log this to the event log.
        if (!EventLog.SourceExists("ThreadException"))
        {
            EventLog.CreateEventSource("ThreadException", "Application");
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "ThreadException";
        myLog.WriteEntry(errorMsg + ex.Message + "\n\nStack Trace:\n" + ex.StackTrace);
    }
    catch (Exception exc)
    {
        try
        {
            MessageBox.Show("Fatal Non-UI Error",
                "Fatal Non-UI Error. Could not write the error to the event log. Reason: "
                + exc.Message, MessageBoxButtons.OK, MessageBoxIcon.Stop);
        }
        finally
        {
            Application.Exit();
        }
    }
}

// Creates the error message and displays it.
private static DialogResult ShowThreadExceptionDialog(string title, Exception e)
{
    string errorMsg = "An application error occurred. Please contact the adminstrator " +
        "with the following information:\n\n";
    errorMsg = errorMsg + e.Message + "\n\nStack Trace:\n" + e.StackTrace;
    return MessageBox.Show(errorMsg, title, MessageBoxButtons.AbortRetryIgnore,
        MessageBoxIcon.Stop);
}

SecurityPermission

for the immediate caller to call unmanaged code when adding a handler to this event. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: