Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

Process.BeginErrorReadLine-Methode

Startet asynchrone Lesevorgänge im umgeleiteten StandardError-Stream der Anwendung.

Namespace:  System.Diagnostics
Assembly:  System (in System.dll)
[ComVisibleAttribute(false)]
public void BeginErrorReadLine()
Ausnahme Bedingung
InvalidOperationException

Die ProcessStartInfo.RedirectStandardError-Eigenschaft ist false.

- oder -

Ein asynchroner Lesevorgang wird bereits im StandardError-Stream ausgeführt.

- oder -

Der StandardError-Stream wurde von einem synchronen Lesevorgang verwendet.

Der StandardError-Stream kann synchron oder asynchron gelesen werden. Methoden wie Read, ReadLine und ReadToEnd führen synchrone Lesevorgänge im Fehlerausgabestream des Prozesses aus. Diese synchronen Lesevorgänge werden erst beendet, wenn der zugeordnete Process Daten in den StandardError-Stream schreibt oder den Stream schließt.

Im Gegensatz dazu startet BeginErrorReadLine asynchrone Lesevorgänge im StandardError-Stream. Mit dieser Methode wird der festgelegte Ereignishandler für die Streamausgabe aktiviert und eine unmittelbare Rückgabe an den Aufrufer übergeben, der andere Aufgaben durchführen kann, während die Streamausgabe an den Ereignishandler geleitet wird.

Führen Sie die folgenden Schritte aus, um asynchrone Lesevorgänge für StandardError für einen Process auszuführen:

  1. Legen Sie UseShellExecute auf false fest.

  2. Legen Sie RedirectStandardError auf true fest.

  3. Fügen Sie dem ErrorDataReceived-Ereignis den Ereignishandler hinzu. Der Ereignishandler muss der Signatur des System.Diagnostics.DataReceivedEventHandler-Delegaten entsprechen.

  4. Starten Sie Process.

  5. Rufen Sie BeginErrorReadLine für den Process auf. Dieser Aufruf startet asynchrone Lesevorgänge für StandardError.

Beim Starten von asynchronen Lesevorgängen wird der Ereignishandler immer dann aufgerufen, wenn der zugeordnete Process eine Textzeile in den StandardError-Stream schreibt.

Sie können einen asynchronen Lesevorgang abbrechen, indem Sie CancelErrorRead aufrufen. Der Lesevorgang kann vom Aufrufer oder vom Ereignishandler abgebrochen werden. Nach dem Abbruch können Sie BeginErrorReadLine erneut aufrufen, um asynchrone Lesevorgänge fortzusetzen.

Hinweis Hinweis

Sie können keine asynchronen und synchronen Lesevorgänge in einem umgeleiteten Stream kombinieren. Wenn der umgeleitete Stream eines Process im asynchronen oder synchronen Modus geöffnet wird, müssen alle weiteren Lesevorgänge in diesem Stream in demselben Modus ausgeführt werden. Rufen Sie z. B. nach BeginErrorReadLine nicht ReadLine für den StandardError-Stream auf oder umgekehrt. Sie können jedoch zwei verschiedene Streams in unterschiedlichen Modi lesen. Beispielsweise können Sie BeginErrorReadLine aufrufen und dann ReadLine für den StandardOutput-Stream aufrufen.

Im folgenden Beispiel wird der net view-Befehl verwendet, um die verfügbaren Netzwerkressourcen auf einem Remotecomputer aufzulisten. Der Benutzer gibt den Zielcomputernamen als Befehlszeilenargument an. Außerdem kann der Benutzer auch einen Dateinamen für die Fehlerausgabe angeben. Im Beispiel wird die Ausgabe des net-Befehls erfasst, auf das Beenden des Prozesses gewartet, und dann werden die Ausgabeergebnisse in die Konsole geschrieben. Wenn der Benutzer die optionale Fehlerdatei angibt, werden im Beispiel Fehler in die Datei geschrieben.


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


namespace ProcessAsyncStreamSamples
{

    class ProcessNetStreamRedirection
    {
        // Define static variables shared by class methods.
        private static StreamWriter streamError =null;
        private static String netErrorFile = "";
        private static StringBuilder netOutput = null;
        private static bool errorRedirect = false;
        private static bool errorsWritten = false;

        public static void RedirectNetCommandStreams()
        {
            String netArguments;
            Process netProcess;

            // Get the input computer name.
            Console.WriteLine("Enter the computer name for the net view command:");
            netArguments = Console.ReadLine().ToUpper(CultureInfo.InvariantCulture);
            if (String.IsNullOrEmpty(netArguments))
            {
                // Default to the help command if there is not an input argument.
                netArguments = "/?";
            }

            // Check if errors should be redirected to a file.
            errorsWritten = false;
            Console.WriteLine("Enter a fully qualified path to an error log file");
            Console.WriteLine("  or just press Enter to write errors to console:");
            netErrorFile = Console.ReadLine().ToUpper(CultureInfo.InvariantCulture);
            if (!String.IsNullOrEmpty(netErrorFile))
            {
                errorRedirect = true;
            }

            // Note that at this point, netArguments and netErrorFile
            // are set with user input.  If the user did not specify
            // an error file, then errorRedirect is set to false.

            // Initialize the process and its StartInfo properties.
            netProcess = new Process();
            netProcess.StartInfo.FileName = "Net.exe";

            // Build the net command argument list.
            netProcess.StartInfo.Arguments = String.Format("view {0}", 
                netArguments);

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

            // Redirect the standard output of the net command.  
            // This stream is read asynchronously using an event handler.
            netProcess.StartInfo.RedirectStandardOutput = true;
            netProcess.OutputDataReceived += new DataReceivedEventHandler(NetOutputDataHandler);
            netOutput = new StringBuilder();

            if (errorRedirect)
            {
                // Redirect the error output of the net command. 
                netProcess.StartInfo.RedirectStandardError = true;
                netProcess.ErrorDataReceived += new DataReceivedEventHandler(NetErrorDataHandler);
            }
            else 
            {
                // Do not redirect the error output.
                netProcess.StartInfo.RedirectStandardError = false;
            }

            Console.WriteLine("\nStarting process: net {0}", 
                netProcess.StartInfo.Arguments);
            if (errorRedirect)
            {
                Console.WriteLine("Errors will be written to the file {0}", 
                    netErrorFile);
            }

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

            // Start the asynchronous read of the standard output stream.
            netProcess.BeginOutputReadLine();

            if (errorRedirect)
            {
                // Start the asynchronous read of the standard
                // error stream.
                netProcess.BeginErrorReadLine();
            }

            // Let the net command run, collecting the output.
            netProcess.WaitForExit();

            if (streamError != null)
            {
                // Close the error file.
                streamError.Close();
            }
            else 
            {
                // Set errorsWritten to false if the stream is not
                // open.   Either there are no errors, or the error
                // file could not be opened.
                errorsWritten = false;
            }

            if (netOutput.Length > 0)
            {
                // If the process wrote more than just
                // white space, write the output to the console.
                Console.WriteLine("\nPublic network shares from net view:\n{0}\n", 
                    netOutput);
            }

            if (errorsWritten)
            {
                // Signal that the error file had something 
                // written to it.
                String [] errorOutput = File.ReadAllLines(netErrorFile);
                if (errorOutput.Length > 0)
                {
                    Console.WriteLine("\nThe following error output was appended to {0}.",
                        netErrorFile);
                    foreach (String errLine in errorOutput)
                    {
                        Console.WriteLine("  {0}", errLine);
                    }
                }
                Console.WriteLine();
            }

            netProcess.Close();

        }

        private static void NetOutputDataHandler(object sendingProcess, 
            DataReceivedEventArgs outLine)
        {
            // Collect the net view command output.
            if (!String.IsNullOrEmpty(outLine.Data))
            {
                // Add the text to the collected output.
                netOutput.Append(Environment.NewLine + "  " + outLine.Data);
            }
        }

        private static void NetErrorDataHandler(object sendingProcess, 
            DataReceivedEventArgs errLine)
        {
            // Write the error text to the file if there is something
            // to write and an error file has been specified.

            if (!String.IsNullOrEmpty(errLine.Data))
            {
                if (!errorsWritten)
                {
                    if (streamError == null)
                    {
                        // Open the file.
                        try 
                        {
                            streamError = new StreamWriter(netErrorFile, true);
                        }
                        catch (Exception e)
                        {
                            Console.WriteLine("Could not open error file!");
                            Console.WriteLine(e.Message.ToString());
                        }
                    }

                    if (streamError != null)
                    {
                        // Write a header to the file if this is the first
                        // call to the error output handler.
                        streamError.WriteLine();
                        streamError.WriteLine(DateTime.Now.ToString());
                        streamError.WriteLine("Net View error output:");
                    }
                    errorsWritten = true;
                }

                if (streamError != null)
                {
                    // Write redirected errors to the file.
                    streamError.WriteLine(errLine.Data);
                    streamError.Flush();
                }
            }
        }
    }
} 


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1
  • LinkDemand  

    für volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann nicht von teilweise vertrauenswürdigem Code verwendet werden.

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ