Esta documentación está archivada y no tiene mantenimiento.

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

Escribe un mensaje a 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
)
/** @attribute ConditionalAttribute("DEBUG") */ 
public static void WriteIf (
	boolean condition, 
	String message
)
ConditionalAttribute("DEBUG") 
public static function WriteIf (
	condition : boolean, 
	message : String
)
No aplicable.

Parámetros

condition

true para que se escriba un mensaje; en caso contrario, false.

message

Mensaje que se va a escribir.

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

Este método llama al método 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 el seguimiento desactivado, 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 del seguimiento. 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 objeto TraceSwitch denominado generalSwitch. Este modificador se establece fuera del código de ejemplo.

Si el modificador está establecido en TraceLevelError o superior, 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 Verbose, 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() {
    // 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.");
 }


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

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

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

// Create a TraceSwitch.
static var generalSwitch : TraceSwitch = 
   new TraceSwitch("General", "Entire Application")    

static public function MyErrorMethod()
{
   @if(@DEBUG)
   // 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
}

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, 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, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0

XNA Framework

Compatible con: 1.0
Mostrar: