DataReceivedEventHandler Delegat

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.Process.dll

Reprezentuje metodę, która będzie obsługiwać OutputDataReceived zdarzenie lub ErrorDataReceived zdarzenie obiektu Process.

C#

public delegate void DataReceivedEventHandler(object sender, DataReceivedEventArgs e);

Parametry

sender

Object

Źródło zdarzenia.

e

DataReceivedEventArgs

Element DataReceivedEventArgs zawierający dane zdarzenia.

Przykłady

Poniższy przykład kodu ilustruje sposób wykonywania asynchronicznych operacji odczytu na przekierowanym StandardOutput strumieniu polecenia sortowania . Polecenie sortowania to aplikacja konsolowa, która odczytuje i sortuje wprowadzanie tekstu.

W przykładzie tworzony jest DataReceivedEventHandler delegat programu obsługi zdarzeń i kojarzy delegata ze zdarzeniemOutputDataReceived.SortOutputHandler Procedura obsługi zdarzeń odbiera wiersze tekstowe z przekierowanego StandardOutput strumienia, formatuje tekst i zapisuje tekst na ekranie.

C#

// Define the namespaces used by this sample.
using System;
using System.Text;
using System.IO;
using System.Diagnostics;
using System.Threading;
using System.ComponentModel;

namespace ProcessAsyncStreamSamples
{
    class SortOutputRedirection
    {
        // Define static variables shared by class methods.
        private static StringBuilder sortOutput = null;
        private static int numOutputLines = 0;

        public static void SortInputListText()
        {
            // Initialize the process and its StartInfo properties.
            // The sort command is a console application that
            // reads and sorts text input.

            Process sortProcess = new Process();
            sortProcess.StartInfo.FileName = "Sort.exe";

            // Set UseShellExecute to false for redirection.
            sortProcess.StartInfo.UseShellExecute = false;

            // Redirect the standard output of the sort command.
            // This stream is read asynchronously using an event handler.
            sortProcess.StartInfo.RedirectStandardOutput = true;
            sortOutput = new StringBuilder();

            // Set our event handler to asynchronously read the sort output.
            sortProcess.OutputDataReceived += SortOutputHandler;

            // Redirect standard input as well.  This stream
            // is used synchronously.
            sortProcess.StartInfo.RedirectStandardInput = true;

            // Start the process.
            sortProcess.Start();

            // Use a stream writer to synchronously write the sort input.
            StreamWriter sortStreamWriter = sortProcess.StandardInput;

            // Start the asynchronous read of the sort output stream.
            sortProcess.BeginOutputReadLine();

            // Prompt the user for input text lines.  Write each
            // line to the redirected input stream of the sort command.
            Console.WriteLine("Ready to sort up to 50 lines of text");

            String inputText;
            int numInputLines = 0;
            do
            {
                Console.WriteLine("Enter a text line (or press the Enter key to stop):");

                inputText = Console.ReadLine();
                if (!String.IsNullOrEmpty(inputText))
                {
                    numInputLines++;
                    sortStreamWriter.WriteLine(inputText);
                }
            }
            while (!String.IsNullOrEmpty(inputText) && (numInputLines < 50));
            Console.WriteLine("<end of input stream>");
            Console.WriteLine();

            // End the input stream to the sort command.
            sortStreamWriter.Close();

            // Wait for the sort process to write the sorted text lines.
            sortProcess.WaitForExit();

            if (numOutputLines > 0)
            {
                // Write the formatted and sorted output to the console.
                Console.WriteLine($" Sort results = {numOutputLines} sorted text line(s) ");
                Console.WriteLine("----------");
                Console.WriteLine(sortOutput);
            }
            else
            {
                Console.WriteLine(" No input lines were sorted.");
            }

            sortProcess.Close();
        }

        private static void SortOutputHandler(object sendingProcess,
            DataReceivedEventArgs outLine)
        {
            // Collect the sort command output.
            if (!String.IsNullOrEmpty(outLine.Data))
            {
                numOutputLines++;

                // Add the text to the collected output.
                sortOutput.Append(Environment.NewLine +
                    $"[{numOutputLines}] - {outLine.Data}");
            }
        }
    }
}

namespace ProcessAsyncStreamSamples
{

    class ProcessSampleMain
    {
        /// The main entry point for the application.
        static void Main()
        {
            try
            {
                SortOutputRedirection.SortInputListText();
            }
            catch (InvalidOperationException e)
            {
                Console.WriteLine("Exception:");
                Console.WriteLine(e);
            }
        }
    }
}

Uwagi

Podczas tworzenia delegata DataReceivedEventHandler należy zidentyfikować metodę, która będzie obsługiwać zdarzenie. Aby skojarzyć zdarzenie z programem obsługi zdarzeń, dodaj wystąpienie delegata do zdarzenia. Program obsługi zdarzeń jest wywoływany przy każdym wystąpieniu zdarzenia, o ile nie usunięto delegata. Aby uzyskać więcej informacji na temat delegatów programu obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Aby asynchronicznie zebrać przekierowane StandardOutput lub StandardError strumieniowe dane wyjściowe procesu, dodaj program obsługi zdarzeń do zdarzenia OutputDataReceived lub ErrorDataReceived . Te zdarzenia są wywoływane za każdym razem, gdy proces zapisuje wiersz do odpowiedniego przekierowanego strumienia. Po zamknięciu przekierowanego strumienia do procedury obsługi zdarzeń jest wysyłany wiersz o wartości null. Przed uzyskaniem Data dostępu do właściwości upewnij się, że program obsługi zdarzeń sprawdza ten warunek. Możesz na przykład użyć static metody String.IsNullOrEmpty , aby zweryfikować Data właściwość w procedurze obsługi zdarzeń.

Metody rozszerzania

GetMethodInfo(Delegate)

Pobiera obiekt reprezentujący metodę reprezentowaną przez określonego delegata.

Dotyczy

Zobacz też

• DataReceivedEventArgs
• OutputDataReceived
• ErrorDataReceived
• Process