This documentation is archived and is not being maintained.

TrackingWorkflowTerminatedEventArgs Class

Contains data associated with the termination of a workflow instance.

Namespace:  System.Workflow.Runtime.Tracking
Assembly:  System.Workflow.Runtime (in System.Workflow.Runtime.dll)

[SerializableAttribute]
public class TrackingWorkflowTerminatedEventArgs : EventArgs

A TrackingWorkflowTerminatedEventArgs is generated by the runtime tracking infrastructure when a workflow instance is terminated. If the TrackingProfile associated with a workflow instance includes a WorkflowTrackPoint configured for a TerminatedTrackingWorkflowEvent, the workflow tracking infrastructure puts the TrackingWorkflowTerminatedEventArgs in EventArgs in the WorkflowTrackingRecord that it sends to the tracking service.

A workflow instance may be terminated in one of three ways: the host may call WorkflowInstance.Terminate; a TerminateActivity activity may be invoked from inside the workflow instance; or an unhandled exception may occur. If the workflow is terminated by the host or a TerminateActivity activity, the runtime tracking infrastructure sets Exception to a WorkflowTerminatedException that has its Message property set to a description of the reason for the termination. If the workflow is terminated because of an unhandled exception, the runtime tracking infrastructure passes the unhandled exception in Exception.

NoteNote:

TrackingWorkflowTerminatedEventArgs is used only by the runtime tracking service to pass information in a WorkflowTrackingRecord. The data for a WorkflowRuntime.WorkflowTerminated event is passed in a WorkflowTerminatedEventArgs.

The following code example demonstrates a method, named WriteTerminatedEventArgs, which captures a TrackingWorkflowTerminatedEventArgs. The code checks whether the Exception property is null (Nothing in Visual Basic). If it is not, the code writes the message associated with the Exception property to the console. If Exception is null (Nothing), the code does not write any exception information to the console.

This code example is part of the EventArgs Tracking SDK Sample from the Program.cs file. For more information, see EventArgs Tracking Sample.

static void WriteTerminatedEventArgs(string eventDescription, TrackingWorkflowTerminatedEventArgs terminatedEventArgs, DateTime eventDataTime)
{
    Console.WriteLine("\nTerminated Event Arguments Read From Tracking Database:\n");
    Console.WriteLine("EventDataTime: " + eventDataTime.ToString());
    Console.WriteLine("EventDescription: " + eventDescription);
    if (null != terminatedEventArgs.Exception)
    {
        Console.WriteLine("TerminatedEventArgs Exception Message: " + terminatedEventArgs.Exception.Message.ToString());
    }
}

System.Object
  System.EventArgs
    System.Workflow.Runtime.Tracking.TrackingWorkflowTerminatedEventArgs

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0
Show: