WorkflowApplicationUnhandledExceptionEventArgs Classe

Définition

Espace de noms:

System.Activities

Assembly:

System.Activities.dll

Fournit des informations sur une exception non gérée qui s’est produite dans une instance de workflow.

public ref class WorkflowApplicationUnhandledExceptionEventArgs : System::Activities::WorkflowApplicationEventArgs

public class WorkflowApplicationUnhandledExceptionEventArgs : System.Activities.WorkflowApplicationEventArgs

type WorkflowApplicationUnhandledExceptionEventArgs = class
    inherit WorkflowApplicationEventArgs

Public Class WorkflowApplicationUnhandledExceptionEventArgs
Inherits WorkflowApplicationEventArgs

Héritage

Object

EventArgs

WorkflowApplicationEventArgs

WorkflowApplicationUnhandledExceptionEventArgs

Exemples

L’exemple suivant appelle un workflow qui lève une exception. L’exception n’est pas gérée par le flux de travail et le gestionnaire OnUnhandledException est appelé. Les WorkflowApplicationUnhandledExceptionEventArgs sont inspectées pour fournir des informations sur l’exception et le flux de travail est arrêté.

Activity wf = new Sequence
{
    Activities =
     {
         new WriteLine
         {
             Text = "Starting the workflow."
         },
         new Throw
        {
            Exception = new InArgument<Exception>((env) =>
                new ApplicationException("Something unexpected happened."))
        },
        new WriteLine
         {
             Text = "Ending the workflow."
         }
     }
};

WorkflowApplication wfApp = new WorkflowApplication(wf);

wfApp.OnUnhandledException = delegate(WorkflowApplicationUnhandledExceptionEventArgs e)
{
    // Display the unhandled exception.
    Console.WriteLine("OnUnhandledException in Workflow {0}\n{1}",
        e.InstanceId, e.UnhandledException.Message);

    Console.WriteLine("ExceptionSource: {0} - {1}",
        e.ExceptionSource.DisplayName, e.ExceptionSourceInstanceId);

    // Instruct the runtime to terminate the workflow.
    return UnhandledExceptionAction.Terminate;

    // Other choices are UnhandledExceptionAction.Abort and
    // UnhandledExceptionAction.Cancel
};

wfApp.Run();

Remarques

Si une exception est levée par une activité et qu’elle n’est pas gérée, le comportement par défaut consiste à mettre fin à l’instance de workflow. Si un OnUnhandledException gestionnaire est présent, il peut remplacer ce comportement par défaut. Ce gestionnaire donne à l’hôte de flux de travail l’occasion de fournir la gestion appropriée, telle que la journalisation personnalisée, l’abandon du flux de travail, l’annulation du flux de travail ou la fin du flux de travail.

Propriétés

Nom	Description
ExceptionSource	Obtient l’activité qui est la source de l’exception non gérée.
ExceptionSourceInstanceId	Obtient l’identificateur unique de l’instance d’activité qui est la source de l’exception non gérée.
InstanceId	Identificateur unique de l’instance de flux de travail. (Hérité de WorkflowApplicationEventArgs)
UnhandledException	Obtient l’élément Exception non géré par l’instance de flux de travail.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetInstanceExtensions<T>()	Obtient la collection d’extensions du type spécifié. (Hérité de WorkflowApplicationEventArgs)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)