Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Debug.WriteLineIf (Boolean, String, String)

 

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento en el Listeners colección si una condición es true.

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

[ConditionalAttribute("DEBUG")]
public static void WriteLineIf(
	bool condition,
	string message,
	string category
)

Parámetros

condition
Type: System.Boolean

true para que se escriba un mensaje; de lo contrario, false.

message
Type: System.String

Mensaje que se va a escribir.

category
Type: System.String

Nombre de categoría usado para organizar el resultado.

De forma predeterminada, se escribe el resultado en una instancia de DefaultTraceListener.

El category parámetro puede utilizarse para agrupar mensajes de resultados.

Este método llama a la TraceListener.WriteLine método del agente de escucha de seguimiento.

Notas para implementadores:

Puede minimizar la reducción del rendimiento de instrumentación de la aplicación mediante el uso de If...Then en lugar de WriteLineIf instrucciones. Los siguientes dos ejemplos de código envían el mismo mensaje de depuración. Sin embargo, el primer ejemplo es mucho más rápido cuando el seguimiento está desactivado, porque si mySwitch.TraceError se evalúa como false, no se llama WriteLine. El segundo ejemplo siempre se llama WriteLineIf, incluso cuando mySwitch.TraceError es false y no se produce ningún resultado de seguimiento. Esto puede producir en la ejecución innecesaria de código arbitrariamente complejo.

Primer ejemplo:

if(mySwitch.TraceError) 
    Debug.WriteLine("aNumber = " + aNumber + " out of range");

Segundo ejemplo:

Debug.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

En el ejemplo siguiente se crea un TraceSwitch denominado generalSwitch. Este modificador se establece fuera del ejemplo de código.

Si el modificador está establecido en el TraceLevelError o superior, el ejemplo genera el primer mensaje de error para el Listeners. Para obtener información sobre cómo agregar un agente de escucha para el Listeners colección, consulte la TraceListenerCollection clase.

A continuación, si la TraceLevel se establece en Verbose, el ejemplo genera el segundo mensaje de error y la category en la misma línea que el primer mensaje. Un terminador de línea sigue el segundo mensaje.

// Class-level declaration.
 // Create a TraceSwitch.
 static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

 static public void MyErrorMethod(String category) {
    // Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.", category);
 }

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: