220017 Walkthrough Using Datatow in a Windows Foems Applicaton Walkthrough: Using Dataflow in a Windows Forms Application -NET Framework (current version) This document demonstrates how to create a network of dataflow blocks that perform image processing in a Windows Forms application. This example loads image files from the specified folder, creates a composite image, and displays the result. The example uses ‘the dataflow model to route images through the network. In the dataflow model, independent components of a program communicate with one another by sending messages. When a component receives a message, it performs some action and then. passes the result to another component. Compare this with the control flow model, in which an application uses control structures, for example, conditional statements, loops, and so on, to control the order of operations in a program Prerequisites Read Dataflow before you start this walkthrough. ‘Tip The TPL Dataflow Library (System.Threading,Tasks Dataflow namespace) is not distributed with the NET Framework 4.5. To install the System. Threading. Tasks.Dataflow namespace, open your project in Visual Studio 2012, choose Manage NuGet Packages from the Project menu, and search online for the Microsoft .Tpl .Dataflow package The TPL Dataflow Library (System. Threading. asks Dataflow namespace) is not distributed with the NET Framework 4.5. To install the System. Threacling.Tasks.Dataflow namespace, open your project in Visual Studio 2012, choose Manage NuGet Packages from the Project menu, and search online for the Microsoft. Tpl.Dataflow package Sections This walkthrough contains the following sections: © Creating the Windows Forms Application Creating the Dataflow Network © Connecting the Dataflow Network to the User Interface # The Complete Example Creating the Windows Forms Application ‘This section describes how to create the basic Windows Forms application and add controls to the main form. To Create the Windows Forms Application 1. In Visual Studio, create a Visual C# or Visual Basic Windows Forms Application project. In this document, the project is named Compositelnages, 2. On the form designer for the main form, Form1.cs (Form/.vb for Visual Basic), add a ToolStrip control hpssimsch microsoft comen-usibrarynh228606{deprirtr v=vs. 110) aspx 13220017 Walkthrough Using Datatow in a Windows Foems Applicaton 3, Add a ToolStripButton control to the ToolStrip control, Set the DisplayStyle property to Text and the Text property to Choose Folder. 4, Add a second ToolStripButton control to the ToolStrip control, Set the DisplayStyle property to Text, the Text property to Cancel, and the Enabled property to False. 5, Add a PictureBox object to the main form, Set the Dock property to Fill Creating the Dataflow Network ‘This section describes how to create the dataflow network that performs image processing To Create the Dataflow Network 1, Add a reference to System.Threading,Tasks.Dataflow.dll to your project. 2. Ensure that Form1.cs (Form1.vb for Visual Basic) contains the following using (Using in Visual Basic) statements: ce using System using System.Collections.Generic; using System.Drawing; using System. Drawing. Imaging; using System.10; using System.Ling; using System. Threading; using System. Threading. Tasks; using System. Threading. Tasks .Dataflow; using System.Windows Forms; 3. Add the following data members to the Form class: {ce | // The head of the dataflow network. ITargetBlockcstring> headBlock = null; // Enables the user interface to signal cancellation to the network. Cancel lationTokenSource cancellationTokenSource; 4, Add the following method, CreatetnageProcessingNetwork, to the Fornd class This method creates the image processing network. // Creates the image processing dataflow network and returns the 11 head node of the network. TTargetBlock CreateInagePracessingNetwork() t uw // Create the dataflow blocks that form the network. uw // Create a dataflow block that takes a folder path as input // and returns a collection of Bitmap objects. var loadBitmaps = new TransformBlock>(path { try ra return LoadBitmaps(path); } catch (OperationCanceledexception) thipssimsch microsoft comen-usibraryhh228606{ eprint v=vs. 110). aspx ang.220017 Walkthrough Using Datatow in a Windows Foems Applicaton // Handle cancellation by passing the empty collection // to the next stage of the network. return Enumerable.Empty(); x ys // Create a dataflow block that takes a collection of Bitmap objects // and returns a single conposite bitmap. var createCompositeBitmap = new TransfornBlock, Bitmap> (bitmaps => { try { + catch (OperationCanceledéxception) { return CreateConpositeBitmap(bitmaps) ; // Handle cancellation by passing null to the next stage 11 of the network. return nulls } ns // Create a dataflow block that displays the provided bitmap on the form. var displayCompositeBitnap = new ActionBlock(bitmap => « // Display the bitmap. pictureBox1.Sizetiode = PictureBoxSizeMode.StretchInage; pictureBox1.Inage = bitmap; // Enable the user to select another folder. toolstripButtont.Enabled = true; ‘toolstripButton2.Enabled = false; Cursor = DefaultCursor; b // Specify a task scheduler from the current synchronization context // so that the action runs on the UT thread. new ExecutionDataflowBlockoptions « TaskScheduler = TaskScheduler.FronCurrentSynchronizationContext () ns // Create a dataflow block that responds to a cancellation request by // displaying an image to indicate that the operation is cancelled and // enables the user to select another folder. var operationCancelled = new ActionBlock