Trace.WriteIf 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
WriteIf(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 |
WriteIf(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 |
WriteIf(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 |
WriteIf(Boolean, String) |
Escribe un mensaje a los agentes de escucha de la colección Listeners si una condición es |
WriteIf(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 WriteIf(bool condition, System::String ^ message, System::String ^ category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteIf (bool condition, string? message, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteIf (bool condition, string message, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteIf : bool * string * string -> unit
Public Shared Sub WriteIf (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 TraceLevelVerbose
en , 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 Error
en TraceLevel o superior, 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 Verbose.
Trace::WriteIf( generalSwitch->TraceVerbose,
String::Concat( myObject,
" is not a valid object for category: " ), category );
// Write a second message if the TraceSwitch level is set
// to Error or higher.
Trace::WriteLineIf( generalSwitch->TraceError,
" Please use a different 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 Verbose.
Trace.WriteIf(generalSwitch.TraceVerbose, myObject.ToString() +
" is not a valid object for category: ", category);
// Write a second message if the TraceSwitch level is set to Error or higher.
Trace.WriteLineIf(generalSwitch.TraceError, " Please use a different 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 Verbose.
Trace.WriteIf(generalSwitch.TraceVerbose, myObject.ToString() & _
" is not a valid object for category: ", category)
' Write a second message if the TraceSwitch level is set to Error or higher.
Trace.WriteLineIf(generalSwitch.TraceError, _
" Please use a different 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 Write 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 WriteIf(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
Write(String). El segundo ejemplo siempre llama a WriteIf(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.Write("aNumber = " + aNumber + " out of range");
Segundo ejemplo
Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");
Consulte también
Se aplica a
WriteIf(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 WriteIf(bool condition, System::Object ^ value, System::String ^ category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteIf (bool condition, object? value, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteIf (bool condition, object value, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteIf : bool * obj * string -> unit
Public Shared Sub WriteIf (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 TraceLevelVerbose
en , el ejemplo genera el nombre de myObject
y en category
.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 Error
en TraceLevel o superior, 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 Verbose.
Trace::WriteIf( generalSwitch->TraceVerbose, myObject, category );
// Write a second message if the TraceSwitch level is set to
// Error or higher.
Trace::WriteLineIf( generalSwitch->TraceError,
" Object is not valid for this 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 Verbose.
Trace.WriteIf(generalSwitch.TraceVerbose, myObject, category);
// Write a second message if the TraceSwitch level is set to Error or higher.
Trace.WriteLineIf(generalSwitch.TraceError, " Object is not valid for this 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 Verbose.
Trace.WriteIf(generalSwitch.TraceVerbose, myObject, category)
' Write a second message if the TraceSwitch level is set to Error or higher.
Trace.WriteLineIf(generalSwitch.TraceError, _
" Object is not valid for this 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 Write 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 WriteIf(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
Write(String). El segundo ejemplo siempre llama a WriteIf(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.Write("aNumber = " + aNumber + " out of range");
Segundo ejemplo
Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");
Consulte también
Se aplica a
WriteIf(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 WriteIf(bool condition, System::Object ^ value);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteIf (bool condition, object? value);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteIf (bool condition, object value);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteIf : bool * obj -> unit
Public Shared Sub WriteIf (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 nombre del parámetro value 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 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.
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, 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." );
#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, 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 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, 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 Sub
Comentarios
De forma predeterminada, la salida se escribe en una instancia de DefaultTraceListener.
Este método llama al Write 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 WriteIf(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
Write(String). El segundo ejemplo siempre llama a WriteIf(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.Write("aNumber = " + aNumber + " out of range");
Segundo ejemplo
Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");
Consulte también
Se aplica a
WriteIf(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 WriteIf(bool condition, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteIf (bool condition, string? message);
[System.Diagnostics.Conditional("TRACE")]
public static void WriteIf (bool condition, string message);
[<System.Diagnostics.Conditional("TRACE")>]
static member WriteIf : bool * string -> unit
Public Shared Sub WriteIf (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 Write 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 WriteIf(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
Write(String). El segundo ejemplo siempre llama a WriteIf(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.Write("aNumber = " + aNumber + " out of range");
Segundo ejemplo
Trace.WriteIf(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