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.WriteIf (Boolean, String)

 

Publicado: octubre de 2016

Escribe 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 Shared Sub WriteIf (
	condition As Boolean,
	message As String
)

Parámetros

condition
Type: System.Boolean

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

message
Type: System.String

Mensaje que se va a escribir.

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

Este método llama a la Write 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 WriteIf 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 Write. El segundo ejemplo siempre se llama WriteIf, 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.Write("aNumber = " + aNumber + " out of range");

Segundo ejemplo:

Debug.WriteIf(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 acerca de 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 en la misma línea que el primer mensaje. Un terminador de línea sigue el segundo mensaje.

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod()
    ' 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.WriteIf(generalSwitch.TraceVerbose, "My second error message.")
End Sub 'MyErrorMethod

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