Trace.WriteLineIf Método
Definición
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 el seguimiento en la 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 en la colección Listeners si una condición es |
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 |
WriteLineIf(Boolean, String) |
Escribe un mensaje a los agentes de escucha de la colección Listeners si una condición es |
WriteLineIf(Boolean, String, String) |
Escribe un nombre de categoría y un mensaje a los agentes de escucha de la colección Listeners si una condición es |
WriteLineIf(Boolean, Object, String)
- Source:
- Trace.cs
- Source:
- Trace.cs
- Source:
- Trace.cs
Escribe un nombre de categoría y el valor del método ToString() del objeto en los agentes de escucha en 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("TRACE")]
public static void WriteLineIf (bool condition, object? value, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLineIf (bool condition, object value, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLineIf : bool * obj * string -> unit
Public Shared Sub WriteLineIf (condition As Boolean, value As Object, category As String)
Parámetros
- condition
- Boolean
true
para que se escriba un mensaje; de lo contrario, false
.
- category
- String
Nombre de categoría usado para organizar el resultado.
- Atributos
Ejemplos
En el ejemplo siguiente se crea un TraceSwitch objeto denominado generalSwitch
. Este modificador se establece fuera del ejemplo de código.
Si el modificador se establece en o TraceLevelError
superior, el ejemplo genera el primer mensaje de error en .Listeners Para obtener información sobre cómo agregar un agente de escucha a la Listeners colección, vea la TraceListenerCollection clase .
A continuación, si se establece Verbose
en TraceLevel , el ejemplo genera el segundo mensaje de error 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.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod( Object^ myObject, String^ category )
{
#if defined(TRACE)
// Write the message if the TraceSwitch level is set
// to Error or higher.
Trace::WriteIf( generalSwitch->TraceError,
"Invalid object for category. " );
// Write a second message if the TraceSwitch level is set
// to Verbose.
Trace::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.
Trace.WriteIf(generalSwitch.TraceError, "Invalid object for category. ");
// Write a second message if the TraceSwitch level is set to Verbose.
Trace.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.
Trace.WriteIf(generalSwitch.TraceError, "Invalid object for category. ")
' Write a second message if the TraceSwitch level is set to Verbose.
Trace.WriteLineIf(generalSwitch.TraceVerbose, myObject, category)
End Sub
Comentarios
De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.
El category
parámetro se puede usar para agrupar mensajes de salida.
Este método llama al WriteLine método del agente de escucha de seguimiento.
Notas a los desarrolladores de herederos
Puede minimizar la penalización del rendimiento de instrumentar la aplicación mediante If...Then
instrucciones en lugar de instrucciones using 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 no se llama a false
WriteLine(String). El segundo ejemplo siempre llama a WriteLineIf(Boolean, String), incluso cuando mySwitch.TraceError
es false
y no se genera ninguna salida de seguimiento. Esto puede dar lugar a la ejecución innecesaria de código arbitrariomente complejo.
Primer ejemplo
if(mySwitch.TraceError)
Trace.WriteLine("aNumber = " + aNumber + " out of range");
Segundo ejemplo
Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");
Consulte también
Se aplica a
WriteLineIf(Boolean, Object)
- Source:
- Trace.cs
- Source:
- Trace.cs
- Source:
- Trace.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("TRACE")]
public static void WriteLineIf (bool condition, object? value);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLineIf (bool condition, object value);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLineIf : bool * obj -> unit
Public Shared Sub WriteLineIf (condition As Boolean, value As Object)
Parámetros
- condition
- Boolean
true
para que se escriba un mensaje; de lo contrario, false
.
- Atributos
Ejemplos
En el ejemplo siguiente se crea un TraceSwitch objeto denominado generalSwitch
. Este modificador se establece fuera del ejemplo de código.
Si el modificador se establece en o TraceLevelError
superior, el ejemplo genera el primer mensaje de error en .Listeners Para obtener información sobre cómo agregar un agente de escucha a la Listeners colección, vea la TraceListenerCollection clase .
A continuación, si se establece Verbose
en TraceLevel , el ejemplo genera el nombre del objeto 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.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod( Object^ myObject )
{
#if defined(TRACE)
// Write the message if the TraceSwitch level
// is set to Error or higher.
Trace::WriteIf( generalSwitch->TraceError, "Invalid object. " );
// Write a second message if the TraceSwitch level is set
// to Verbose.
Trace::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.
Trace.WriteIf(generalSwitch.TraceError, "Invalid object. ");
// Write a second message if the TraceSwitch level is set to Verbose.
Trace.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.
Trace.WriteIf(generalSwitch.TraceError, "Invalid object. ")
' Write a second message if the TraceSwitch level is set to Verbose.
Trace.WriteLineIf(generalSwitch.TraceVerbose, myObject)
End Sub
Comentarios
De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.
Este método llama al WriteLine método del agente de escucha de seguimiento.
Notas a los desarrolladores de herederos
Puede minimizar la penalización del rendimiento de instrumentar la aplicación mediante If...Then
instrucciones en lugar de instrucciones using 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 no se llama a false
WriteLine(String). El segundo ejemplo siempre llama a WriteLineIf(Boolean, String), incluso cuando mySwitch.TraceError
es false
y no se genera ninguna salida de seguimiento. Esto puede dar lugar a la ejecución innecesaria de código arbitrariomente complejo.
Primer ejemplo
if(mySwitch.TraceError)
Trace.WriteLine("aNumber = " + aNumber + " out of range");
Segundo ejemplo
Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");
Consulte también
Se aplica a
WriteLineIf(Boolean, String)
- Source:
- Trace.cs
- Source:
- Trace.cs
- Source:
- Trace.cs
Escribe un mensaje a los agentes de escucha de la colección Listeners si una condición es true
.
public:
static void WriteLineIf(bool condition, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLineIf (bool condition, string? message);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLineIf (bool condition, string message);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLineIf : bool * string -> unit
Public Shared Sub WriteLineIf (condition As Boolean, message As String)
Parámetros
- condition
- Boolean
true
para que se escriba un mensaje; de lo contrario, false
.
- message
- String
Mensaje que se va a escribir.
- Atributos
Ejemplos
En el ejemplo siguiente se crea un TraceSwitch objeto denominado generalSwitch
. Este modificador se establece fuera del ejemplo de código.
Si el modificador se establece en o TraceLevelError
superior, el ejemplo genera el primer mensaje de error en .Listeners Para obtener información sobre cómo agregar un agente de escucha a la Listeners colección, vea la TraceListenerCollection clase .
A continuación, si se establece Verbose
en TraceLevel , el ejemplo genera el segundo mensaje de error 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.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod()
{
#if defined(TRACE)
// Write the message if the TraceSwitch level is set to
// Error or higher.
Trace::WriteIf( generalSwitch->TraceError, "My error message. " );
// Write a second message if the TraceSwitch level is set
// to Verbose.
Trace::WriteLineIf( generalSwitch->TraceVerbose,
"My second error message." );
#endif
}
// 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.
Trace.WriteIf(generalSwitch.TraceError, "My error message. ");
// Write a second message if the TraceSwitch level is set to Verbose.
Trace.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.
Trace.WriteIf(generalSwitch.TraceError, "My error message. ")
' Write a second message if the TraceSwitch level is set to Verbose.
Trace.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 WriteLine método del agente de escucha de seguimiento.
Notas a los desarrolladores de herederos
Puede minimizar la penalización del rendimiento de instrumentar la aplicación mediante If...Then
instrucciones en lugar de instrucciones using 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 no se llama a false
WriteLine(String). El segundo ejemplo siempre llama a WriteLineIf(Boolean, String), incluso cuando mySwitch.TraceError
es false
y no se genera ninguna salida de seguimiento. Esto puede dar lugar a la ejecución innecesaria de código arbitrariomente complejo.
Primer ejemplo
if(mySwitch.TraceError)
Trace.WriteLine("aNumber = " + aNumber + " out of range");
Segundo ejemplo
Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");
Consulte también
Se aplica a
WriteLineIf(Boolean, String, String)
- Source:
- Trace.cs
- Source:
- Trace.cs
- Source:
- Trace.cs
Escribe un nombre de categoría y un mensaje a los agentes de escucha 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("TRACE")]
public static void WriteLineIf (bool condition, string? message, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteLineIf (bool condition, string message, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLineIf : bool * string * string -> unit
Public Shared Sub WriteLineIf (condition As Boolean, message As String, category As String)
Parámetros
- condition
- Boolean
true
para que se escriba un mensaje; de lo contrario, false
.
- message
- String
Mensaje que se va a escribir.
- category
- String
Nombre de categoría usado para organizar el resultado.
- Atributos
Ejemplos
En el ejemplo siguiente se crea un TraceSwitch objeto denominado generalSwitch
. Este modificador se establece fuera del ejemplo de código.
Si el modificador se establece en o TraceLevelError
superior, el ejemplo genera el primer mensaje de error en .Listeners Para obtener información sobre cómo agregar un agente de escucha a la Listeners colección, vea la TraceListenerCollection clase .
A continuación, si se establece Verbose
en TraceLevel , el ejemplo genera el segundo mensaje de error y en category
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.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod( String^ category )
{
#if defined(TRACE)
// Write the message if the TraceSwitch level is set
// to Error or higher.
Trace::WriteIf( generalSwitch->TraceError, "My error message. " );
// Write a second message if the TraceSwitch level is set
// to Verbose.
Trace::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.
Trace.WriteIf(generalSwitch.TraceError, "My error message. ");
// Write a second message if the TraceSwitch level is set to Verbose.
Trace.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.
Trace.WriteIf(generalSwitch.TraceError, "My error message. ")
' Write a second message if the TraceSwitch level is set to Verbose.
Trace.WriteLineIf(generalSwitch.TraceVerbose, _
"My second error message.", category)
End Sub
Comentarios
De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.
El category
parámetro se puede usar para agrupar mensajes de salida.
Este método llama al WriteLine método del agente de escucha de seguimiento.
Notas a los desarrolladores de herederos
Puede minimizar la penalización del rendimiento de instrumentar la aplicación mediante If...Then
instrucciones en lugar de instrucciones using 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 no se llama a false
WriteLine(String). El segundo ejemplo siempre llama a WriteLineIf(Boolean, String), incluso cuando mySwitch.TraceError
es false
y no se genera ninguna salida de seguimiento. Esto puede dar lugar a la ejecución innecesaria de código arbitrariomente complejo.
Primer ejemplo
if(mySwitch.TraceError)
Trace.WriteLine("aNumber = " + aNumber + " out of range");
Segundo ejemplo
Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");
Consulte también
Se aplica a
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de