Walkthrough: Gegevensstroom gebruiken in een Windows Forms-toepassing

Artikel
04/08/2023

In dit artikel ziet u hoe u een netwerk van gegevensstroomblokken maakt die afbeeldingsverwerking uitvoeren in een Windows Forms-toepassing.

In dit voorbeeld worden afbeeldingsbestanden uit de opgegeven map geladen, wordt een samengestelde afbeelding gemaakt en wordt het resultaat weergegeven. In het voorbeeld wordt het gegevensstroommodel gebruikt om afbeeldingen via het netwerk te routeren. In het gegevensstroommodel communiceren onafhankelijke onderdelen van een programma met elkaar door berichten te verzenden. Wanneer een onderdeel een bericht ontvangt, wordt er een actie uitgevoerd en wordt het resultaat vervolgens doorgegeven aan een ander onderdeel. Vergelijk dit met het controlestroommodel, waarin een toepassing besturingsstructuren gebruikt, bijvoorbeeld voorwaardelijke instructies, lussen, enzovoort, om de volgorde van bewerkingen in een programma te bepalen.

Vereisten

Lees Gegevensstroom voordat u aan dit scenario begint.

Notitie

De TPL-gegevensstroombibliotheek (de System.Threading.Tasks.Dataflow naamruimte) wordt niet gedistribueerd met .NET. Als u de System.Threading.Tasks.Dataflow naamruimte in Visual Studio wilt installeren, opent u uw project, kiest u NuGet-pakketten beheren in het menu Project en zoekt u online naar het System.Threading.Tasks.Dataflow pakket. U kunt het ook installeren met behulp van de .NET Core CLI door uit te voeren dotnet add package System.Threading.Tasks.Dataflow.

Secties

Dit overzicht bevat de volgende secties:

De Windows Forms-toepassing maken
Het gegevensstroomnetwerk maken
Het gegevensstroomnetwerk verbinden met de gebruikersinterface
Het volledige voorbeeld

De Windows Forms-toepassing maken

In deze sectie wordt beschreven hoe u de basistoepassing Windows Forms maakt en besturingselementen toevoegt aan het hoofdformulier.

De Windows Forms-toepassing maken

Maak in Visual Studio een Visual C# of Visual Basic Windows Forms Application-project. In dit document heeft het project de naam CompositeImages.
Voeg in de formulierontwerper voor het hoofdformulier Form1.cs (Form1.vb voor Visual Basic) een ToolStrip besturingselement toe.
Voeg een ToolStripButton besturingselement toe aan het ToolStrip besturingselement. Stel de DisplayStyle eigenschap in op Text en de Text eigenschap op Map kiezen.
Voeg een tweede ToolStripButton besturingselement toe aan het ToolStrip besturingselement. Stel de DisplayStyle eigenschap in op Text, de Text eigenschap op Annuleren en de Enabled eigenschap op False.
Voeg een PictureBox -object toe aan het hoofdformulier. Stel de Dock eigenschap in op Fill.

Het gegevensstroomnetwerk maken

In deze sectie wordt beschreven hoe u het gegevensstroomnetwerk maakt dat afbeeldingsverwerking uitvoert.

Het gegevensstroomnetwerk maken

Voeg een verwijzing naar System.Threading.Tasks.Dataflow.dll toe aan uw project.

Zorg ervoor dat Form1.cs (Form1.vb voor Visual Basic) de volgende using instructies (Using in Visual Basic) bevat:

using System;
using System.Collections.Generic;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.Threading.Tasks.Dataflow;
using System.Windows.Forms;

Voeg de volgende gegevensleden toe aan de Form1 klasse:

// The head of the dataflow network.
ITargetBlock<string> headBlock = null;

// Enables the user interface to signal cancellation to the network.
CancellationTokenSource cancellationTokenSource;

Voeg de volgende methode, CreateImageProcessingNetwork, toe aan de Form1 klasse . Met deze methode wordt het netwerk voor de verwerking van afbeeldingen gemaakt.

// Creates the image processing dataflow network and returns the
// head node of the network.
ITargetBlock<string> CreateImageProcessingNetwork()
{
   //
   // Create the dataflow blocks that form the network.
   //

   // Create a dataflow block that takes a folder path as input
   // and returns a collection of Bitmap objects.
   var loadBitmaps = new TransformBlock<string, IEnumerable<Bitmap>>(path =>
      {
         try
         {
            return LoadBitmaps(path);
         }
         catch (OperationCanceledException)
         {
            // Handle cancellation by passing the empty collection
            // to the next stage of the network.
            return Enumerable.Empty<Bitmap>();
         }
      });

   // Create a dataflow block that takes a collection of Bitmap objects
   // and returns a single composite bitmap.
   var createCompositeBitmap = new TransformBlock<IEnumerable<Bitmap>, Bitmap>(bitmaps =>
      {
         try
         {
            return CreateCompositeBitmap(bitmaps);
         }
         catch (OperationCanceledException)
         {
            // Handle cancellation by passing null to the next stage
            // of the network.
            return null;
         }
      });

   // Create a dataflow block that displays the provided bitmap on the form.
   var displayCompositeBitmap = new ActionBlock<Bitmap>(bitmap =>
      {
         // Display the bitmap.
         pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
         pictureBox1.Image = bitmap;

         // Enable the user to select another folder.
         toolStripButton1.Enabled = true;
         toolStripButton2.Enabled = false;
         Cursor = DefaultCursor;
      },
      // Specify a task scheduler from the current synchronization context
      // so that the action runs on the UI thread.
      new ExecutionDataflowBlockOptions
      {
          TaskScheduler = TaskScheduler.FromCurrentSynchronizationContext()
      });

   // 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<object>(delegate
      {
         // Display the error image to indicate that the operation
         // was cancelled.
         pictureBox1.SizeMode = PictureBoxSizeMode.CenterImage;
         pictureBox1.Image = pictureBox1.ErrorImage;

         // Enable the user to select another folder.
         toolStripButton1.Enabled = true;
         toolStripButton2.Enabled = false;
         Cursor = DefaultCursor;
      },
      // Specify a task scheduler from the current synchronization context
      // so that the action runs on the UI thread.
      new ExecutionDataflowBlockOptions
      {
         TaskScheduler = TaskScheduler.FromCurrentSynchronizationContext()
      });

   //
   // Connect the network.
   //

   // Link loadBitmaps to createCompositeBitmap.
   // The provided predicate ensures that createCompositeBitmap accepts the
   // collection of bitmaps only if that collection has at least one member.
   loadBitmaps.LinkTo(createCompositeBitmap, bitmaps => bitmaps.Count() > 0);

   // Also link loadBitmaps to operationCancelled.
   // When createCompositeBitmap rejects the message, loadBitmaps
   // offers the message to operationCancelled.
   // operationCancelled accepts all messages because we do not provide a
   // predicate.
   loadBitmaps.LinkTo(operationCancelled);

   // Link createCompositeBitmap to displayCompositeBitmap.
   // The provided predicate ensures that displayCompositeBitmap accepts the
   // bitmap only if it is non-null.
   createCompositeBitmap.LinkTo(displayCompositeBitmap, bitmap => bitmap != null);

   // Also link createCompositeBitmap to operationCancelled.
   // When displayCompositeBitmap rejects the message, createCompositeBitmap
   // offers the message to operationCancelled.
   // operationCancelled accepts all messages because we do not provide a
   // predicate.
   createCompositeBitmap.LinkTo(operationCancelled);

   // Return the head of the network.
   return loadBitmaps;
}

Implementeer de LoadBitmaps methode.

// Loads all bitmap files that exist at the provided path.
IEnumerable<Bitmap> LoadBitmaps(string path)
{
   List<Bitmap> bitmaps = new List<Bitmap>();

   // Load a variety of image types.
   foreach (string bitmapType in
      new string[] { "*.bmp", "*.gif", "*.jpg", "*.png", "*.tif" })
   {
      // Load each bitmap for the current extension.
      foreach (string fileName in Directory.GetFiles(path, bitmapType))
      {
         // Throw OperationCanceledException if cancellation is requested.
         cancellationTokenSource.Token.ThrowIfCancellationRequested();

         try
         {
            // Add the Bitmap object to the collection.
            bitmaps.Add(new Bitmap(fileName));
         }
         catch (Exception)
         {
            // TODO: A complete application might handle the error.
         }
      }
   }
   return bitmaps;
}

Implementeer de CreateCompositeBitmap methode.

// Creates a composite bitmap from the provided collection of Bitmap objects.
// This method computes the average color of each pixel among all bitmaps
// to create the composite image.
Bitmap CreateCompositeBitmap(IEnumerable<Bitmap> bitmaps)
{
   Bitmap[] bitmapArray = bitmaps.ToArray();

   // Compute the maximum width and height components of all
   // bitmaps in the collection.
   Rectangle largest = new Rectangle();
   foreach (var bitmap in bitmapArray)
   {
      if (bitmap.Width > largest.Width)
         largest.Width = bitmap.Width;
      if (bitmap.Height > largest.Height)
         largest.Height = bitmap.Height;
   }

   // Create a 32-bit Bitmap object with the greatest dimensions.
   Bitmap result = new Bitmap(largest.Width, largest.Height,
      PixelFormat.Format32bppArgb);

   // Lock the result Bitmap.
   var resultBitmapData = result.LockBits(
      new Rectangle(new Point(), result.Size), ImageLockMode.WriteOnly,
      result.PixelFormat);

   // Lock each source bitmap to create a parallel list of BitmapData objects.
   var bitmapDataList = (from bitmap in bitmapArray
                         select bitmap.LockBits(
                           new Rectangle(new Point(), bitmap.Size),
                           ImageLockMode.ReadOnly, PixelFormat.Format32bppArgb))
                        .ToList();

   // Compute each column in parallel.
   Parallel.For(0, largest.Width, new ParallelOptions
   {
      CancellationToken = cancellationTokenSource.Token
   },
   i =>
   {
      // Compute each row.
      for (int j = 0; j < largest.Height; j++)
      {
         // Counts the number of bitmaps whose dimensions
         // contain the current location.
         int count = 0;

         // The sum of all alpha, red, green, and blue components.
         int a = 0, r = 0, g = 0, b = 0;

         // For each bitmap, compute the sum of all color components.
         foreach (var bitmapData in bitmapDataList)
         {
            // Ensure that we stay within the bounds of the image.
            if (bitmapData.Width > i && bitmapData.Height > j)
            {
               unsafe
               {
                  byte* row = (byte*)(bitmapData.Scan0 + (j * bitmapData.Stride));
                  byte* pix = (byte*)(row + (4 * i));
                  a += *pix; pix++;
                  r += *pix; pix++;
                  g += *pix; pix++;
                  b += *pix;
               }
               count++;
            }
         }

         //prevent divide by zero in bottom right pixelless corner
         if (count == 0)
             break;

         unsafe
         {
            // Compute the average of each color component.
            a /= count;
            r /= count;
            g /= count;
            b /= count;

            // Set the result pixel.
            byte* row = (byte*)(resultBitmapData.Scan0 + (j * resultBitmapData.Stride));
            byte* pix = (byte*)(row + (4 * i));
            *pix = (byte)a; pix++;
            *pix = (byte)r; pix++;
            *pix = (byte)g; pix++;
            *pix = (byte)b;
         }
      }
   });

   // Unlock the source bitmaps.
   for (int i = 0; i < bitmapArray.Length; i++)
   {
      bitmapArray[i].UnlockBits(bitmapDataList[i]);
   }

   // Unlock the result bitmap.
   result.UnlockBits(resultBitmapData);

   // Return the result.
   return result;
}

Notitie

De C#-versie van de CreateCompositeBitmap methode maakt gebruik van aanwijzers om efficiënte verwerking van de System.Drawing.Bitmap objecten mogelijk te maken. Daarom moet u de optie Onveilige code toestaan in uw project inschakelen om het onveilige trefwoord te kunnen gebruiken. Zie Build Page, Project Designer (C#) voor meer informatie over het inschakelen van onveilige code in een Visual C#-project.

In de volgende tabel worden de leden van het netwerk beschreven.

Lid	Type	Description
`loadBitmaps`	TransformBlock<TInput,TOutput>	Neemt een mappad als invoer en produceert een verzameling Bitmap objecten als uitvoer.
`createCompositeBitmap`	TransformBlock<TInput,TOutput>	Neemt een verzameling Bitmap objecten als invoer en produceert een samengestelde bitmap als uitvoer.
`displayCompositeBitmap`	ActionBlock<TInput>	Hiermee wordt de samengestelde bitmap op het formulier weergegeven.
`operationCancelled`	ActionBlock<TInput>	Geeft een afbeelding weer om aan te geven dat de bewerking is geannuleerd en stelt de gebruiker in staat een andere map te selecteren.

In dit voorbeeld wordt de LinkTo methode gebruikt om de gegevensstroomblokken te verbinden om een netwerk te vormen. De LinkTo methode bevat een overbelaste versie die een Predicate<T> -object gebruikt dat bepaalt of het doelblok een bericht accepteert of afwijst. Met dit filtermechanisme kunnen berichtblokken alleen bepaalde waarden ontvangen. In dit voorbeeld kan het netwerk op twee manieren vertakken. De hoofdvertakking laadt de installatiekopieën van schijf, maakt de samengestelde installatiekopieën en geeft die afbeelding weer op het formulier. De alternatieve vertakking annuleert de huidige bewerking. Met Predicate<T> de objecten kunnen de gegevensstroomblokken langs de hoofdvertakking overschakelen naar de alternatieve vertakking door bepaalde berichten te weigeren. Als de gebruiker bijvoorbeeld de bewerking annuleert, produceert null het gegevensstroomblok createCompositeBitmap (Nothingin Visual Basic) als uitvoer. Het gegevensstroomblok displayCompositeBitmap weigert null invoerwaarden en daarom wordt het bericht aangeboden aan operationCancelled. Het gegevensstroomblok operationCancelled accepteert alle berichten en geeft daarom een afbeelding weer om aan te geven dat de bewerking is geannuleerd.

In de volgende afbeelding ziet u het netwerk voor de verwerking van afbeeldingen:

Afbeelding van het netwerk voor de verwerking van afbeeldingen.

Omdat de displayCompositeBitmap gegevensstroomblokken en operationCancelled reageren op de gebruikersinterface, is het belangrijk dat deze acties worden uitgevoerd op de thread van de gebruikersinterface. Om dit te bereiken, bieden deze objecten tijdens de constructie elk een ExecutionDataflowBlockOptions -object waarvoor de TaskScheduler eigenschap is ingesteld op TaskScheduler.FromCurrentSynchronizationContext. Met de TaskScheduler.FromCurrentSynchronizationContext methode wordt een TaskScheduler -object gemaakt dat werk uitvoert in de huidige synchronisatiecontext. Omdat de CreateImageProcessingNetwork methode wordt aangeroepen vanuit de handler van de knop Map kiezen , die wordt uitgevoerd op de gebruikersinterfacethread, worden de acties voor de displayCompositeBitmap gegevensstroomblokken en operationCancelled ook uitgevoerd op de gebruikersinterfacethread.

In dit voorbeeld wordt een gedeeld annuleringstoken gebruikt in plaats van de CancellationToken eigenschap in te stellen, omdat de eigenschap de CancellationToken uitvoering van het gegevensstroomblok definitief annuleert. Met een annuleringstoken kan in dit voorbeeld hetzelfde gegevensstroomnetwerk meerdere keren opnieuw worden gebruikt, zelfs wanneer de gebruiker een of meer bewerkingen annuleert. Zie Procedure: Een gegevensstroomblok annuleren voor een voorbeeld waarin CancellationToken de uitvoering van een gegevensstroomblok definitief wordt geannuleerd.

Het gegevensstroomnetwerk verbinden met de gebruikersinterface

In deze sectie wordt beschreven hoe u het gegevensstroomnetwerk verbindt met de gebruikersinterface. Het maken van de samengestelde afbeelding en het annuleren van de bewerking worden gestart via de knoppen Map kiezen en Annuleren . Wanneer de gebruiker een van deze knoppen kiest, wordt de juiste actie op een asynchrone manier gestart.

Het gegevensstroomnetwerk verbinden met de gebruikersinterface

Maak in de formulierontwerper voor het hoofdformulier een gebeurtenis-handler voor de Click gebeurtenis voor de knop Map kiezen .

Implementeer de Click gebeurtenis voor de knop Map kiezen .

// Event handler for the Choose Folder button.
private void toolStripButton1_Click(object sender, EventArgs e)
{
   // Create a FolderBrowserDialog object to enable the user to
   // select a folder.
   FolderBrowserDialog dlg = new FolderBrowserDialog
   {
      ShowNewFolderButton = false
   };

   // Set the selected path to the common Sample Pictures folder
   // if it exists.
   string initialDirectory = Path.Combine(
      Environment.GetFolderPath(Environment.SpecialFolder.CommonPictures),
      "Sample Pictures");
   if (Directory.Exists(initialDirectory))
   {
      dlg.SelectedPath = initialDirectory;
   }

   // Show the dialog and process the dataflow network.
   if (dlg.ShowDialog() == DialogResult.OK)
   {
      // Create a new CancellationTokenSource object to enable
      // cancellation.
      cancellationTokenSource = new CancellationTokenSource();

      // Create the image processing network if needed.
      headBlock ??= CreateImageProcessingNetwork();

      // Post the selected path to the network.
      headBlock.Post(dlg.SelectedPath);

      // Enable the Cancel button and disable the Choose Folder button.
      toolStripButton1.Enabled = false;
      toolStripButton2.Enabled = true;

      // Show a wait cursor.
      Cursor = Cursors.WaitCursor;
   }
}

Maak in de formulierontwerper voor het hoofdformulier een gebeurtenis-handler voor de Click gebeurtenis voor de knop Annuleren .

Implementeer de Click gebeurtenis voor de knop Annuleren .

// Event handler for the Cancel button.
private void toolStripButton2_Click(object sender, EventArgs e)
{
   // Signal the request for cancellation. The current component of
   // the dataflow network will respond to the cancellation request.
   cancellationTokenSource.Cancel();
}

Het volledige voorbeeld

In het volgende voorbeeld ziet u de volledige code voor dit scenario.

using System;
using System.Collections.Generic;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.Threading.Tasks.Dataflow;
using System.Windows.Forms;

namespace CompositeImages
{
   public partial class Form1 : Form
   {
      // The head of the dataflow network.
      ITargetBlock<string> headBlock = null;

      // Enables the user interface to signal cancellation to the network.
      CancellationTokenSource cancellationTokenSource;

      public Form1()
      {
         InitializeComponent();
      }

      // Creates the image processing dataflow network and returns the
      // head node of the network.
      ITargetBlock<string> CreateImageProcessingNetwork()
      {
         //
         // Create the dataflow blocks that form the network.
         //

         // Create a dataflow block that takes a folder path as input
         // and returns a collection of Bitmap objects.
         var loadBitmaps = new TransformBlock<string, IEnumerable<Bitmap>>(path =>
            {
               try
               {
                  return LoadBitmaps(path);
               }
               catch (OperationCanceledException)
               {
                  // Handle cancellation by passing the empty collection
                  // to the next stage of the network.
                  return Enumerable.Empty<Bitmap>();
               }
            });

         // Create a dataflow block that takes a collection of Bitmap objects
         // and returns a single composite bitmap.
         var createCompositeBitmap = new TransformBlock<IEnumerable<Bitmap>, Bitmap>(bitmaps =>
            {
               try
               {
                  return CreateCompositeBitmap(bitmaps);
               }
               catch (OperationCanceledException)
               {
                  // Handle cancellation by passing null to the next stage
                  // of the network.
                  return null;
               }
            });

         // Create a dataflow block that displays the provided bitmap on the form.
         var displayCompositeBitmap = new ActionBlock<Bitmap>(bitmap =>
            {
               // Display the bitmap.
               pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
               pictureBox1.Image = bitmap;

               // Enable the user to select another folder.
               toolStripButton1.Enabled = true;
               toolStripButton2.Enabled = false;
               Cursor = DefaultCursor;
            },
            // Specify a task scheduler from the current synchronization context
            // so that the action runs on the UI thread.
            new ExecutionDataflowBlockOptions
            {
                TaskScheduler = TaskScheduler.FromCurrentSynchronizationContext()
            });

         // 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<object>(delegate
            {
               // Display the error image to indicate that the operation
               // was cancelled.
               pictureBox1.SizeMode = PictureBoxSizeMode.CenterImage;
               pictureBox1.Image = pictureBox1.ErrorImage;

               // Enable the user to select another folder.
               toolStripButton1.Enabled = true;
               toolStripButton2.Enabled = false;
               Cursor = DefaultCursor;
            },
            // Specify a task scheduler from the current synchronization context
            // so that the action runs on the UI thread.
            new ExecutionDataflowBlockOptions
            {
               TaskScheduler = TaskScheduler.FromCurrentSynchronizationContext()
            });

         //
         // Connect the network.
         //

         // Link loadBitmaps to createCompositeBitmap.
         // The provided predicate ensures that createCompositeBitmap accepts the
         // collection of bitmaps only if that collection has at least one member.
         loadBitmaps.LinkTo(createCompositeBitmap, bitmaps => bitmaps.Count() > 0);

         // Also link loadBitmaps to operationCancelled.
         // When createCompositeBitmap rejects the message, loadBitmaps
         // offers the message to operationCancelled.
         // operationCancelled accepts all messages because we do not provide a
         // predicate.
         loadBitmaps.LinkTo(operationCancelled);

         // Link createCompositeBitmap to displayCompositeBitmap.
         // The provided predicate ensures that displayCompositeBitmap accepts the
         // bitmap only if it is non-null.
         createCompositeBitmap.LinkTo(displayCompositeBitmap, bitmap => bitmap != null);

         // Also link createCompositeBitmap to operationCancelled.
         // When displayCompositeBitmap rejects the message, createCompositeBitmap
         // offers the message to operationCancelled.
         // operationCancelled accepts all messages because we do not provide a
         // predicate.
         createCompositeBitmap.LinkTo(operationCancelled);

         // Return the head of the network.
         return loadBitmaps;
      }

      // Loads all bitmap files that exist at the provided path.
      IEnumerable<Bitmap> LoadBitmaps(string path)
      {
         List<Bitmap> bitmaps = new List<Bitmap>();

         // Load a variety of image types.
         foreach (string bitmapType in
            new string[] { "*.bmp", "*.gif", "*.jpg", "*.png", "*.tif" })
         {
            // Load each bitmap for the current extension.
            foreach (string fileName in Directory.GetFiles(path, bitmapType))
            {
               // Throw OperationCanceledException if cancellation is requested.
               cancellationTokenSource.Token.ThrowIfCancellationRequested();

               try
               {
                  // Add the Bitmap object to the collection.
                  bitmaps.Add(new Bitmap(fileName));
               }
               catch (Exception)
               {
                  // TODO: A complete application might handle the error.
               }
            }
         }
         return bitmaps;
      }

      // Creates a composite bitmap from the provided collection of Bitmap objects.
      // This method computes the average color of each pixel among all bitmaps
      // to create the composite image.
      Bitmap CreateCompositeBitmap(IEnumerable<Bitmap> bitmaps)
      {
         Bitmap[] bitmapArray = bitmaps.ToArray();

         // Compute the maximum width and height components of all
         // bitmaps in the collection.
         Rectangle largest = new Rectangle();
         foreach (var bitmap in bitmapArray)
         {
            if (bitmap.Width > largest.Width)
               largest.Width = bitmap.Width;
            if (bitmap.Height > largest.Height)
               largest.Height = bitmap.Height;
         }

         // Create a 32-bit Bitmap object with the greatest dimensions.
         Bitmap result = new Bitmap(largest.Width, largest.Height,
            PixelFormat.Format32bppArgb);

         // Lock the result Bitmap.
         var resultBitmapData = result.LockBits(
            new Rectangle(new Point(), result.Size), ImageLockMode.WriteOnly,
            result.PixelFormat);

         // Lock each source bitmap to create a parallel list of BitmapData objects.
         var bitmapDataList = (from bitmap in bitmapArray
                               select bitmap.LockBits(
                                 new Rectangle(new Point(), bitmap.Size),
                                 ImageLockMode.ReadOnly, PixelFormat.Format32bppArgb))
                              .ToList();

         // Compute each column in parallel.
         Parallel.For(0, largest.Width, new ParallelOptions
         {
            CancellationToken = cancellationTokenSource.Token
         },
         i =>
         {
            // Compute each row.
            for (int j = 0; j < largest.Height; j++)
            {
               // Counts the number of bitmaps whose dimensions
               // contain the current location.
               int count = 0;

               // The sum of all alpha, red, green, and blue components.
               int a = 0, r = 0, g = 0, b = 0;

               // For each bitmap, compute the sum of all color components.
               foreach (var bitmapData in bitmapDataList)
               {
                  // Ensure that we stay within the bounds of the image.
                  if (bitmapData.Width > i && bitmapData.Height > j)
                  {
                     unsafe
                     {
                        byte* row = (byte*)(bitmapData.Scan0 + (j * bitmapData.Stride));
                        byte* pix = (byte*)(row + (4 * i));
                        a += *pix; pix++;
                        r += *pix; pix++;
                        g += *pix; pix++;
                        b += *pix;
                     }
                     count++;
                  }
               }

               //prevent divide by zero in bottom right pixelless corner
               if (count == 0)
                   break;

               unsafe
               {
                  // Compute the average of each color component.
                  a /= count;
                  r /= count;
                  g /= count;
                  b /= count;

                  // Set the result pixel.
                  byte* row = (byte*)(resultBitmapData.Scan0 + (j * resultBitmapData.Stride));
                  byte* pix = (byte*)(row + (4 * i));
                  *pix = (byte)a; pix++;
                  *pix = (byte)r; pix++;
                  *pix = (byte)g; pix++;
                  *pix = (byte)b;
               }
            }
         });

         // Unlock the source bitmaps.
         for (int i = 0; i < bitmapArray.Length; i++)
         {
            bitmapArray[i].UnlockBits(bitmapDataList[i]);
         }

         // Unlock the result bitmap.
         result.UnlockBits(resultBitmapData);

         // Return the result.
         return result;
      }

      // Event handler for the Choose Folder button.
      private void toolStripButton1_Click(object sender, EventArgs e)
      {
         // Create a FolderBrowserDialog object to enable the user to
         // select a folder.
         FolderBrowserDialog dlg = new FolderBrowserDialog
         {
            ShowNewFolderButton = false
         };

         // Set the selected path to the common Sample Pictures folder
         // if it exists.
         string initialDirectory = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.CommonPictures),
            "Sample Pictures");
         if (Directory.Exists(initialDirectory))
         {
            dlg.SelectedPath = initialDirectory;
         }

         // Show the dialog and process the dataflow network.
         if (dlg.ShowDialog() == DialogResult.OK)
         {
            // Create a new CancellationTokenSource object to enable
            // cancellation.
            cancellationTokenSource = new CancellationTokenSource();

            // Create the image processing network if needed.
            headBlock ??= CreateImageProcessingNetwork();

            // Post the selected path to the network.
            headBlock.Post(dlg.SelectedPath);

            // Enable the Cancel button and disable the Choose Folder button.
            toolStripButton1.Enabled = false;
            toolStripButton2.Enabled = true;

            // Show a wait cursor.
            Cursor = Cursors.WaitCursor;
         }
      }

      // Event handler for the Cancel button.
      private void toolStripButton2_Click(object sender, EventArgs e)
      {
         // Signal the request for cancellation. The current component of
         // the dataflow network will respond to the cancellation request.
         cancellationTokenSource.Cancel();
      }

      ~Form1()
      {
         cancellationTokenSource.Dispose();
      }
   }
}

In de volgende afbeelding ziet u typische uitvoer voor de algemene map \Sample Pictures\.

De TPLDataflow_CompositeImages van de Windows Forms-toepassing

Zie ook

Gegevensstroom

Delen via

Walkthrough: Gegevensstroom gebruiken in een Windows Forms-toepassing

Vereisten

Secties

De Windows Forms-toepassing maken

De Windows Forms-toepassing maken

Het gegevensstroomnetwerk maken

Het gegevensstroomnetwerk maken

Het gegevensstroomnetwerk verbinden met de gebruikersinterface

Het gegevensstroomnetwerk verbinden met de gebruikersinterface

Het volledige voorbeeld

Zie ook

Aanvullende resources