WriteIf Método (Boolean, String, String)
Collapse the table of content
Expand the table of content
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

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

 

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

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

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

Parámetros

condition

Expresión condicional que se va a evaluar.Si la condición es true, el nombre de categoría y el mensaje se escriben en los agentes de escucha de seguimiento de la colección.

message

Mensaje que se va a escribir.

category

Nombre de categoría utilizado para organizar el resultado.

El resultado se escribe de forma predeterminada en una instancia de DefaultTraceListener.

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

Este método llama al método TraceListener.Write del agente de escucha de seguimiento.

Notas para los implementadores:

Para minimizar la disminución del rendimiento al instrumentar la aplicación, utilice instrucciones If...Then en lugar de instrucciones WriteIf.Los dos ejemplos de código siguientes envían el mismo mensaje de depuración.Sin embargo, el primer ejemplo resulta mucho más rápido con la traza desactivada, ya que si mySwitch.TraceError se evalúa como false, no se llamará a Write.El segundo ejemplo siempre llama a WriteIf, aunque mySwitch.TraceError sea false y no se genere ningún resultado de traza.Esto puede resultar en la ejecución innecesaria de código arbitrariamente complejo.

Primer ejemplo:

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

Segundo ejemplo:

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

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

Si el modificador está establecido en TraceLevelVerbose, el ejemplo genera el primer mensaje de error en Listeners.Para obtener información acerca de cómo agregar un agente de escucha a la colección de Listeners, vea la clase TraceListenerCollection.

A continuación, si la enumeración TraceLevel está establecida en Error o superior, el ejemplo genera el segundo mensaje de error en la misma línea que el primer mensaje.Al segundo mensaje le sigue un terminador de línea.

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

 static public void MyErrorMethod(Object myObject, String category) {
    // Write the message if the TraceSwitch level is set to Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, myObject.ToString() + 
       " is not a valid object for category: ", category);

    // Write a second message if the TraceSwitch level is set to Error or higher.
    Debug.WriteLineIf(generalSwitch.TraceError, " Please use a different category.");
 }

Universal Windows Platform
Disponible desde 10
.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar:
© 2016 Microsoft