Exportar (0) Imprimir
Expandir todo
Este tema aún no ha recibido ninguna valoración - Valorar este tema

Trace.WriteIf (Método) (Boolean, Object)

Escribe el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.

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

[ConditionalAttribute("TRACE")] 
public static void WriteIf (
	bool condition,
	Object value
)
/** @attribute ConditionalAttribute("TRACE") */ 
public static void WriteIf (
	boolean condition, 
	Object value
)
ConditionalAttribute("TRACE") 
public static function WriteIf (
	condition : boolean, 
	value : Object
)
No aplicable.

Parámetros

condition

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

value

Object cuyo nombre se envía a la propiedad Listeners.

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. En los dos ejemplos de código siguientes se envía el mismo mensaje de depuración. Sin embargo, el primer ejemplo resulta mucho más rápido con el seguimiento desactivado, porque si mySwitch.TraceError se evalúa como false, no se llamará a Write. En el segundo ejemplo siempre se llama a WriteIf, aunque mySwitch.TraceError sea false y no se genere ningún resultado de seguimiento. Esto puede resultar en la ejecución innecesaria de código arbitrariamente complejo. Primer ejemplo

if(mySwitch.TraceError) 
    Trace.Write("aNumber = " + aNumber + " out of range");
Segundo ejemplo
Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

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

Si el modificador está establecido en TraceLevelError o mayor, se envía en el ejemplo el primer nombre del parámetro de valor a la colección Listeners. Para obtener información sobre cómo agregar un agente de escucha a la colección Listeners, vea la clase TraceListenerCollection.

A continuación, si TraceLevel se ha establecido en Verbose, en el ejemplo se enviará un mensaje en la misma línea que el primer mensaje. El segundo mensaje va seguido de 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) {
    // Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.TraceError, myObject);
 
    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, " is not a valid value for this method.");
 }


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

public static void MyErrorMethod(Object myObject)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.get_TraceError(), myObject);

    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.get_TraceVerbose(), 
        "is not a valid value for this method.");
} //MyErrorMethod

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

function MyErrorMethod(myObject : Object)
{
   @if(@TRACE)
   // Write the message if the TraceSwitch level is set to
   // Error or higher.
   Trace.WriteIf(generalSwitch.TraceError, myObject)

   // Write a second message if the TraceSwitch level is set to Verbose.
   Trace.WriteLineIf(generalSwitch.TraceVerbose, 
      " is not a valid value for this method.")
   @end
}

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, 1.1, 1.0

XNA Framework

Compatible con: 1.0
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.