Exportar (0) Imprimir
Expandir todo

DataReceivedEventArgs.Data (Propiedad)

Obtiene la línea de caracteres escrita en una secuencia de salida Process redirigida.

Espacio de nombres: System.Diagnostics
Ensamblado: System (en system.dll)

public string Data { get; }
/** @property */
public String get_Data ()

public function get Data () : String

No aplicable.

Valor de propiedad

Línea escrita por una secuencia Process asociada en su secuencia StandardOutput o StandardError redirigida.

Cuando se redirige la secuencia StandardOutput o StandardError de un objeto Process al controlador de evento, se provoca un evento cada vez que el proceso escribe una línea en la secuencia redirigida. La propiedad Data es la línea que el objeto Process escribió en la secuencia de salida redirigida. El controlador de evento puede utilizar la propiedad Data para filtrar el resultado del proceso o escribir el resultado en una ubicación alternativa. Por ejemplo, se podría crear un controlador de evento que almacene todas las líneas de salida de error en un archivo de registro de errores designado.

Se define una línea como una secuencia de caracteres seguida de un salto de línea ("\n") o un retorno de carro seguido de un salto de línea ("\r\n"). Los caracteres de la línea están codificados mediante la página de códigos ANSI predeterminada del sistema. La propiedad Data no incluye el carácter de retorno de carro o avance de línea final.

Cuando la secuencia redirigida se cierra, se envía a una línea vacía al controlador del evento. Asegúrese de que el controlador del evento compruebe la propiedad Data de forma apropiada antes de obtener acceso a ella. Por ejemplo, puede utilizar el método estático String.IsNullOrEmpty para validar la propiedad Data en el controlador del evento.

El ejemplo de código siguiente ilustra un controlador de evento simple asociado al evento OutputDataReceived. El controlador del evento recibe líneas de texto de la secuencia StandardOutput redirigida, aplica formato al texto y escribe el texto en la pantalla.

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.ToString() + "] - " + outLine.Data);
    }
}

Windows 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft