Task 1: Listen For and Process Events
In this task, you learn how to interact with the Windows Workflow Foundation runtime engine during your application life cycle. Events are raised by the runtime engine during significant events. This lets you customize your application based on the current status of the runtime engine and any workflows that are executing.
This task focuses on handling the events that are raised by the runtime engine. Task 2: Suspend, Terminate, and Resume Workflows focuses on handling events that the runtime engine raises during the execution of a workflow.
Note
Although you are encouraged to follow the exercises in a linear manner, it is not required. You can start this exercise by opening the sample project and proceeding to the steps in the following section.
To add event handlers for the WorkflowRuntime.Started and WorkflowRuntime.Stopped events
After the assignment of the workflowRuntime object in the Main method of your hosting application, create an event handler for the Started event that is defined on the workflowRuntime object.
Note
To correctly handle the System.Workflow.Runtime.WorkflowRuntime.Started event, the event handler must be added before you start the runtime.
// workflow runtime events workflowRuntime.Started += new EventHandler<WorkflowRuntimeEventArgs>(workflowRuntime_Started);
After the Started event handler, create an event handler for the Stopped event that is defined on the workflowRuntime object.
workflowRuntime.Stopped += new EventHandler<WorkflowRuntimeEventArgs>(workflowRuntime_Stopped);
In the Program class, create a new static method named workflowRuntime_Started.
This method takes an Object named sender and a WorkflowRuntimeEventArgs object named e as parameters.
Call the WriteLine method to write an informative message to the system console.
static void workflowRuntime_Started(object sender, WorkflowRuntimeEventArgs e) { Console.WriteLine("Workflow runtime started"); }
In the Program class, create a new static method named workflowRuntime_Stopped.
This method takes an Object named sender and a WorkflowRuntimeEventArgs object named e as parameters.
Call the WriteLine method to write an informative message to the system console.
static void workflowRuntime_Stopped(object sender, WorkflowRuntimeEventArgs e) { Console.WriteLine("Workflow runtime stopped"); }
Compiling the Code
For information about compiling your code, see Compiling the Code.
In Task 2: Suspend, Terminate, and Resume Workflows, you learn how to create event handlers for specific workflow events.
See Also
Reference
WorkflowRuntime
Started
Stopped
Concepts
Creating a Workflow Host Application
Other Resources
Task 2: Suspend, Terminate, and Resume Workflows
Raise Event To Load Workflow
Copyright © 2007 by Microsoft Corporation. All rights reserved.
Last Published: 2010-03-04