DataReceivedEventArgs.Data Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Origem:

DataReceivedEventArgs.cs

Obtém a linha de caracteres que foi gravada em um fluxo de saída Process redirecionado.

public:
 property System::String ^ Data { System::String ^ get(); };

public string? Data { get; }

member this.Data : string

Public ReadOnly Property Data As String

Valor da propriedade

String

A linha que foi escrita por uma Process associada ao seu fluxo redirecionado StandardOutput ou StandardError.

Exemplos

O exemplo de código a seguir ilustra um manipulador de eventos simples associado ao OutputDataReceived evento. O manipulador de eventos recebe linhas de texto do fluxo redirecionado StandardOutput , formata o texto e grava o texto na tela.

using namespace System;
using namespace System::IO;
using namespace System::Diagnostics;
using namespace System::Text;

ref class StandardAsyncOutputExample
{
private:
    static int lineCount = 0;
    static StringBuilder^ output = nullptr;

public:
    static void Run()
    {
        Process^ process = gcnew Process();
        process->StartInfo->FileName = "ipconfig.exe";
        process->StartInfo->UseShellExecute = false;
        process->StartInfo->RedirectStandardOutput = true;
        output = gcnew StringBuilder();
        process->OutputDataReceived += gcnew DataReceivedEventHandler(OutputHandler);
        process->Start();

        // Asynchronously read the standard output of the spawned process. 
        // This raises OutputDataReceived events for each line of output.
        process->BeginOutputReadLine();
        process->WaitForExit();

        // Write the redirected output to this application's window.
        Console::WriteLine(output);

        process->WaitForExit();
        process->Close();

        Console::WriteLine("\n\nPress any key to exit");
        Console::ReadLine();
    }

private:
    static void OutputHandler(Object^ sender, DataReceivedEventArgs^ e)
    {
        // Prepend line numbers to each line of the output.
        if (!String::IsNullOrEmpty(e->Data))
        {
            lineCount++;
            output->Append("\n[" + lineCount + "]: " + e->Data);
        }
    }
};

int main()
{
    StandardAsyncOutputExample::Run();
}

using System;
using System.IO;
using System.Diagnostics;
using System.Text;

class StandardAsyncOutputExample
{
    private static int lineCount = 0;
    private static StringBuilder output = new StringBuilder();

    public static void Main()
    {
        Process process = new Process();
        process.StartInfo.FileName = "ipconfig.exe";
        process.StartInfo.UseShellExecute = false;
        process.StartInfo.RedirectStandardOutput = true;
        process.OutputDataReceived += new DataReceivedEventHandler((sender, e) =>
        {
            // Prepend line numbers to each line of the output.
            if (!String.IsNullOrEmpty(e.Data))
            {
                lineCount++;
                output.Append("\n[" + lineCount + "]: " + e.Data);
            }
        });

        process.Start();

        // Asynchronously read the standard output of the spawned process.
        // This raises OutputDataReceived events for each line of output.
        process.BeginOutputReadLine();
        process.WaitForExit();

        // Write the redirected output to this application's window.
        Console.WriteLine(output);

        process.WaitForExit();
        process.Close();

        Console.WriteLine("\n\nPress any key to exit.");
        Console.ReadLine();
    }
}

Imports System.IO
Imports System.Diagnostics
Imports System.Text

Module Module1
    Dim lineCount As Integer = 0
    Dim output As StringBuilder = New StringBuilder()

    Sub Main()
        Dim process As New Process()
        process.StartInfo.FileName = "ipconfig.exe"
        process.StartInfo.UseShellExecute = False
        process.StartInfo.RedirectStandardOutput = True
        AddHandler process.OutputDataReceived, AddressOf OutputHandler
        process.Start()

        ' Asynchronously read the standard output of the spawned process. 
        ' This raises OutputDataReceived events for each line of output.
        process.BeginOutputReadLine()
        process.WaitForExit()

        Console.WriteLine(output)

        process.WaitForExit()
        process.Close()

        Console.WriteLine(Environment.NewLine + Environment.NewLine + "Press any key to exit.")
        Console.ReadLine()
    End Sub

    Sub OutputHandler(sender As Object, e As DataReceivedEventArgs)
        If Not String.IsNullOrEmpty(e.Data) Then
            lineCount += 1

            ' Add the text to the collected output.
            output.Append(Environment.NewLine + "[" + lineCount.ToString() + "]: " + e.Data)
        End If
    End Sub
End Module

Comentários

Quando você redireciona o StandardOutput fluxo ou StandardError de um Process para o manipulador de eventos, um evento é gerado sempre que o processo grava uma linha no fluxo redirecionado. A Data propriedade é a linha que o Process escreveu no fluxo de saída redirecionado. O manipulador de eventos pode usar a Data propriedade para filtrar a saída do processo ou gravar a saída em um local alternativo. Por exemplo, você pode criar um manipulador de eventos que armazena todas as linhas de saída de erro em um arquivo de log de erros designado.

Uma linha é definida como uma sequência de caracteres seguida por um feed de linha ("\n") ou um retorno de carro imediatamente seguido por um feed de linha ("\r\n"). Os caracteres de linha são codificados usando a página de código ANSI do sistema padrão. A Data propriedade não inclui o retorno de carro de terminação ou o feed de linha.

Quando o fluxo redirecionado é fechado, uma linha nula é enviada para o manipulador de eventos. Verifique se o manipulador de eventos verifica a Data propriedade adequadamente antes de acessá-la. Por exemplo, você pode usar o método String.IsNullOrEmpty estático para validar a Data propriedade em seu manipulador de eventos.