Debug.WriteLineIf Método

Referencia

Definición

Espacio de nombres:: System.Diagnostics

Ensamblado:: System.Diagnostics.Debug.dll

Ensamblado:: System.Runtime.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Escribe información sobre la depuración en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.

Sobrecargas

WriteLineIf(Boolean, Object, String)	Escribe un nombre de categoría y 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`.
WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler)	Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners si se `true`una condición especificada.
WriteLineIf(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`.
WriteLineIf(Boolean, String)	Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es `true`.
WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler, String)	Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners si se `true`una condición especificada.
WriteLineIf(Boolean, String, String)	Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es `true`.

WriteLineIf(Boolean, Object, String)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Escribe un nombre de categoría y 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.

public:
 static void WriteLineIf(bool condition, System::Object ^ value, System::String ^ category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, object value, string category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, object? value, string? category);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * obj * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, value As Object, category As String)

Parámetros

condition: Boolean

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

value: Object

Objeto cuyo nombre se envía al Listeners.

category: String

Nombre de categoría usado para organizar la salida.

Atributos: ConditionalAttribute

Ejemplos

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

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

A continuación, si el 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.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod( Object^ myObject, String^ category )
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      #if defined(DEBUG)
      Debug::WriteIf(generalSwitch->TraceError, "Invalid object for category. ");
      
      // Write a second message if the TraceSwitch level is set to Verbose.
      Debug::WriteLineIf( generalSwitch->TraceVerbose, myObject, category );
      #endif
   }

// 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 Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "Invalid object for category. ");

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

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


Public Shared Sub MyErrorMethod(myObject As Object, category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "Invalid object for category. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, myObject, category)
End Sub

Comentarios

De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.

El parámetro category se puede usar para agrupar mensajes de salida.

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

Notas a los desarrolladores de herederos

Puede minimizar la penalización de rendimiento de instrumentar la aplicación mediante instrucciones If...Then en lugar de usar instrucciones WriteLineIf(Boolean, String). Los dos ejemplos de código siguientes 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 a WriteLine(String). El segundo ejemplo siempre llama a WriteLineIf(Boolean, String), incluso cuando mySwitch.TraceError se false y no se genera ninguna salida de seguimiento. Esto puede dar lugar a una ejecución innecesaria de código arbitrario complejo.

Primer ejemplo:

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

Segundo ejemplo:

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

Consulte también

Se aplica a

WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners si se trueuna condición especificada.

public:
 static void WriteLineIf(bool condition, System::Diagnostics::Debug::WriteIfInterpolatedStringHandler % message);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, ref System.Diagnostics.Debug.WriteIfInterpolatedStringHandler message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * WriteIfInterpolatedStringHandler -> unit

Public Shared Sub WriteLineIf (condition As Boolean, ByRef message As Debug.WriteIfInterpolatedStringHandler)

Parámetros

condition: 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: Debug.WriteIfInterpolatedStringHandler

Mensaje que se va a escribir.

Atributos: ConditionalAttribute

Comentarios

Esta sobrecarga se introdujo en .NET 6 para mejorar el rendimiento. En comparación con las sobrecargas que toman un parámetro String, esta sobrecarga solo evalúa los elementos de formato de cadena interpolados si se requiere el mensaje.

De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.

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

Consulte también

Se aplica a

WriteLineIf(Boolean, Object)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

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.

public:
 static void WriteLineIf(bool condition, System::Object ^ value);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, object value);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, object? value);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * obj -> unit

Public Shared Sub WriteLineIf (condition As Boolean, value As Object)

Parámetros

condition: Boolean

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

value: Object

Objeto cuyo nombre se envía al Listeners.

Atributos: ConditionalAttribute

Ejemplos

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

A continuación, si el TraceLevel se establece en Verbose, el ejemplo genera el nombre del objeto 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 = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod( Object^ myObject )
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      #if defined(DEBUG)
      Debug::WriteIf( generalSwitch->TraceError, "Invalid object. " );
      
      // Write a second message if the TraceSwitch level is set to Verbose.
      Debug::WriteLineIf( generalSwitch->TraceVerbose, myObject );
      #endif
   }

// 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.
    Debug.WriteIf(generalSwitch.TraceError, "Invalid object. ");

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

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


Public Shared Sub MyErrorMethod(myObject As Object)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "Invalid object. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, myObject)
End Sub

Comentarios

De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.

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

Notas a los desarrolladores de herederos

Primer ejemplo:

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

Segundo ejemplo:

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

Consulte también

Se aplica a

WriteLineIf(Boolean, String)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

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

public:
 static void WriteLineIf(bool condition, System::String ^ message);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, string message);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, string? message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, message As String)

Parámetros

condition: 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: String

Mensaje que se va a escribir.

Atributos: ConditionalAttribute

Ejemplos

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

A continuación, si el 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.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod()
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      #if defined(DEBUG)
      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." );
      #endif
   }

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

static 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.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.");
}

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

Comentarios

De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.

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

Notas a los desarrolladores de herederos

Primer ejemplo:

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

Segundo ejemplo:

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

Consulte también

Se aplica a

WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler, String)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners si se trueuna condición especificada.

public:
 static void WriteLineIf(bool condition, System::Diagnostics::Debug::WriteIfInterpolatedStringHandler % message, System::String ^ category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, ref System.Diagnostics.Debug.WriteIfInterpolatedStringHandler message, string? category);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * WriteIfInterpolatedStringHandler * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, ByRef message As Debug.WriteIfInterpolatedStringHandler, category As String)

Parámetros

condition: Boolean

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

message: Debug.WriteIfInterpolatedStringHandler

Mensaje que se va a escribir.

category: String

Nombre de categoría usado para organizar la salida.

Atributos: ConditionalAttribute

Comentarios

De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.

El parámetro category se puede usar para agrupar mensajes de salida.

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

Consulte también

Se aplica a

WriteLineIf(Boolean, String, String)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

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

public:
 static void WriteLineIf(bool condition, System::String ^ message, System::String ^ category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, string message, string category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf (bool condition, string? message, string? category);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * string * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, message As String, category As String)

Parámetros

condition: Boolean

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

message: String

Mensaje que se va a escribir.

category: String

Nombre de categoría usado para organizar la salida.

Atributos: ConditionalAttribute

Ejemplos

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

A continuación, si el TraceLevel se establece en Verbose, el ejemplo genera el segundo mensaje de error y el 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 = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod( String^ category )
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      #if defined(DEBUG)
      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 );
      #endif
   }

// 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);
}

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


Public Shared Sub MyErrorMethod(category As String)
    ' 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)
End Sub

Comentarios

De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.

El parámetro category se puede usar para agrupar mensajes de salida.

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

Notas a los desarrolladores de herederos

Primer ejemplo:

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

Segundo ejemplo:

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

Consulte también

Se aplica a

Compartir vía

Debug.WriteLineIf Método

Definición

Sobrecargas

WriteLineIf(Boolean, Object, String)

Parámetros

Ejemplos

Comentarios

Notas a los desarrolladores de herederos

Consulte también

Se aplica a

WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler)

Parámetros

Comentarios

Consulte también

Se aplica a

WriteLineIf(Boolean, Object)

Parámetros

Ejemplos

Comentarios

Notas a los desarrolladores de herederos

Consulte también

Se aplica a

WriteLineIf(Boolean, String)

Parámetros

Ejemplos

Comentarios

Notas a los desarrolladores de herederos

Consulte también

Se aplica a

WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler, String)

Parámetros

Comentarios

Consulte también

Se aplica a

WriteLineIf(Boolean, String, String)

Parámetros

Ejemplos

Comentarios

Notas a los desarrolladores de herederos

Consulte también

Se aplica a

Recursos adicionales