WorkflowApplicationUnhandledExceptionEventArgs Classe

Définition

Fournit des informations sur une exception non gérée qui s'est produite dans une instance de flux de travail.Provides information about an unhandled exception that occurred in a workflow instance.

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
WorkflowApplicationUnhandledExceptionEventArgs

Exemples

L'exemple suivant appelle un workflow qui lève une exception.The following example invokes a workflow that throws an exception. L'exception n'est pas prise en charge par le workflow et le gestionnaire OnUnhandledException est appelé.The exception is unhandled by the workflow and the OnUnhandledException handler is invoked. L'objet WorkflowApplicationUnhandledExceptionEventArgs est inspecté de façon à fournir des informations sur l'exception, et le workflow est arrêté.The WorkflowApplicationUnhandledExceptionEventArgs are inspected to provide information about the exception, and the workflow is terminated.

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 n'est pas gérée, le comportement par défaut consiste à arrêter l'instance de flux de travail.If an exception is thrown by an activity and is unhandled, the default behavior is to terminate the workflow instance. Si un gestionnaire d'événements OnUnhandledException est présent, il peut remplacer ce comportement par défaut.If an OnUnhandledException handler is present, it can override this default behavior. Ce gestionnaire permet à l’auteur hôte du workflow de fournir la gestion appropriée, englobant par exemple l’enregistrement personnalisé, l’abandon de workflow, l’annulation de workflow ou l’arrêt de workflow.This handler gives the workflow host author an opportunity to provide the appropriate handling, such as custom logging, aborting the workflow, canceling the workflow, or terminating the workflow.

Propriétés

ExceptionSource

Obtient l'activité qui est la source de l'exception non gérée.Gets the activity that is the source of the unhandled exception.

ExceptionSourceInstanceId

Obtient l'identificateur unique de l'instance d'activité qui est la source de l'exception non gérée.Gets the unique identifier of the activity instance that is the source of the unhandled exception.

InstanceId

Identificateur unique de l'instance de flux de travail.The unique identifier of the workflow instance.

(Hérité de WorkflowApplicationEventArgs)
UnhandledException

Obtient l'objet Exception qui n'était pas pris en charge par l'instance de flux de travail.Gets the Exception that was unhandled by the workflow instance.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetInstanceExtensions<T>()

Obtient la collection d’extensions du type spécifié.Gets the collection of extensions of the specified type.

(Hérité de WorkflowApplicationEventArgs)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

S’applique à