Trace.Assert Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblados:

netstandard.dll, System.Diagnostics.TraceSource.dll

Comprueba si hay una condición; si la condición es false, genera mensajes y muestra un cuadro de mensaje que muestra la pila de llamadas.

Sobrecargas

Nombre	Description
Assert(Boolean)	Comprueba si hay una condición; si la condición es false, muestra un cuadro de mensaje que muestra la pila de llamadas.
Assert(Boolean, String)	Comprueba si hay una condición; si la condición es false, genera un mensaje especificado y muestra un cuadro de mensaje que muestra la pila de llamadas.
Assert(Boolean, String, String)	Comprueba si hay una condición; si la condición es false, genera dos mensajes especificados y muestra un cuadro de mensaje que muestra la pila de llamadas.

Assert(Boolean)

Source:

Trace.cs

Comprueba si hay una condición; si la condición es false, muestra un cuadro de mensaje que muestra la pila de llamadas.

public:
 static void Assert(bool condition);

[System.Diagnostics.Conditional("TRACE")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);

[<System.Diagnostics.Conditional("TRACE")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unit

Public Shared Sub Assert (condition As Boolean)

Parámetros

condition

Boolean

Expresión condicional que se va a evaluar. Si la condición es true, no se envía un mensaje de error y no se muestra el cuadro de mensaje.

Atributos

ConditionalAttribute OverloadResolutionPriorityAttribute

Ejemplos

En el ejemplo siguiente se crea un índice para una matriz. A continuación, se realiza alguna acción que establece el valor del índice. A continuación, el código llama Assert a para comprobar que el valor de índice es válido. Si no es válido, Assert genera la pila de llamadas.

// Create an index for an array.
int index;

void Method()
{
    // Perform some action that sets the index.

    // Test that the index value is valid.
    Trace.Assert(index > -1);
}

' Create an index for an array.
Protected index As Integer    

Protected Sub Method()
    ' Perform some action that sets the index.
    ' Test that the index value is valid. 
    Trace.Assert(index > -1)
End Sub

Comentarios

Use el Trace.Assert método si desea realizar aserciones en compilaciones de versión. El Debug.Assert método solo funciona en compilaciones de depuración. Para obtener más información, consulte Aserciones en código administrado.

Normalmente, el Assert(Boolean) método se usa para identificar errores lógicos durante el desarrollo del programa. Assert(Boolean) evalúa la condición. Si el resultado es false, envía un mensaje de error a la Listeners colección. Puede personalizar este comportamiento agregando a TraceListener o quitando uno de la Listeners colección.

Cuando la aplicación se ejecuta en modo de interfaz de usuario, muestra un cuadro de mensaje que muestra la pila de llamadas con números de archivo y línea. El cuadro de mensaje contiene tres botones: Anular, Reintentar e Omitir. Al hacer clic en el botón Anular , finaliza la aplicación. Al hacer clic en Reintentar , se le envía al código del depurador si la aplicación se ejecuta en un depurador o ofrece abrir un depurador si no lo está. Al hacer clic en Omitir , continúa con la siguiente instrucción en el código.

Nota:

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener. Si no DefaultTraceListener está en la Listeners colección, no se muestra el cuadro de mensaje. DefaultTraceListener Se puede quitar llamando al Clear método en la Listeners propiedad (System.Diagnostics.Trace.Listeners.Clear()). En el caso de las aplicaciones de .NET Framework, también puede usar el <elemento clear> y el elemento remove> en el< archivo de configuración de la aplicación.

En el caso de las aplicaciones de .NET Framework, puede cambiar el comportamiento de en el archivo de DefaultTraceListener configuración que corresponde al nombre de la aplicación. En este archivo, puede habilitar y deshabilitar el cuadro de mensaje de aserción o establecer la DefaultTraceListener.LogFileName propiedad . El archivo de configuración debe tener el formato siguiente:

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Consulte también

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Assert(Boolean, String)

Source:

Trace.cs

Comprueba si hay una condición; si la condición es false, genera un mensaje especificado y muestra un cuadro de mensaje que muestra la pila de llamadas.

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

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string? message = default);

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

Public Shared Sub Assert (condition As Boolean, Optional message As String = Nothing)

Parámetros

condition

Boolean

Expresión condicional que se va a evaluar. Si la condición es true, no se envía el mensaje especificado y no se muestra el cuadro de mensaje.

message

String

Mensaje que se va a enviar a la Listeners colección.

Atributos

ConditionalAttribute

Ejemplos

En el ejemplo siguiente se comprueba si el type parámetro es válido. Si el type objeto pasado es null, genera Assert un mensaje.

public static void MyMethod(Type type, Type baseType)
{
    Trace.Assert(type != null, "Type parameter is null");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null")

    ' Perform some processing.
End Sub

Comentarios

Use el Trace.Assert método si desea realizar aserciones en compilaciones de versión. El Debug.Assert método solo funciona en compilaciones de depuración. Para obtener más información, consulte Aserciones en código administrado.

Normalmente, el Assert(Boolean, String) método se usa para identificar errores lógicos durante el desarrollo del programa. Assert(Boolean, String) evalúa la condición. Si el resultado es false, envía el mensaje de diagnóstico especificado a la Listeners colección. Puede personalizar este comportamiento agregando a TraceListener o quitando uno de la Listeners colección.

Cuando la aplicación se ejecuta en modo de interfaz de usuario, muestra un cuadro de mensaje que muestra la pila de llamadas con números de archivo y línea. El cuadro de mensaje contiene tres botones: Anular, Reintentar e Omitir. Al hacer clic en el botón Anular , finaliza la aplicación. Al hacer clic en Reintentar , se le envía al código del depurador si la aplicación se ejecuta en un depurador o ofrece abrir un depurador si no lo está. Al hacer clic en Omitir , continúa con la siguiente instrucción en el código.

Nota:

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener. Si no DefaultTraceListener está en la Listeners colección, no se muestra el cuadro de mensaje. DefaultTraceListener Se puede quitar llamando al Clear método en la Listeners propiedad (System.Diagnostics.Trace.Listeners.Clear()). En el caso de las aplicaciones de .NET Framework, también puede usar el <elemento clear> y el elemento remove> en el< archivo de configuración de la aplicación.

En el caso de las aplicaciones de .NET Framework, puede cambiar el comportamiento de en el archivo de DefaultTraceListener configuración que corresponde al nombre de la aplicación. En este archivo, puede habilitar y deshabilitar el cuadro de mensaje de aserción o establecer la DefaultTraceListener.LogFileName propiedad . El archivo de configuración debe tener el formato siguiente:

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Consulte también

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Assert(Boolean, String, String)

Source:

Trace.cs

Comprueba si hay una condición; si la condición es false, genera dos mensajes especificados y muestra un cuadro de mensaje que muestra la pila de llamadas.

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

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string? message, string? detailMessage);

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

Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

Parámetros

condition

Boolean

Expresión condicional que se va a evaluar. Si la condición es true, no se envían los mensajes especificados y no se muestra el cuadro de mensaje.

message

String

Mensaje que se va a enviar a la Listeners colección.

detailMessage

String

Mensaje detallado que se va a enviar a la Listeners colección.

Atributos

ConditionalAttribute

Ejemplos

En el ejemplo siguiente se comprueba si el type parámetro es válido. Si el type objeto pasado es null, genera Assert un mensaje.

public static void MyMethod(Type type, Type baseType)
{
    Trace.Assert(type != null, "Type parameter is null",
       "Can't get object for null type");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null", _
        "Can't get object for null type")

    ' Perform some processing.
End Sub

Comentarios

Use el Trace.Assert método si desea realizar aserciones en compilaciones de versión. El Debug.Assert método solo funciona en compilaciones de depuración. Para obtener más información, consulte Aserciones en código administrado.

Normalmente, el Assert(Boolean, String, String) método se usa para identificar errores lógicos durante el desarrollo del programa. Assert evalúa la condición. Si el resultado es false, envía el mensaje de diagnóstico especificado y el mensaje detallado a la Listeners colección. Puede personalizar este comportamiento agregando a TraceListener o quitando uno de la Listeners colección.

Cuando la aplicación se ejecuta en modo de interfaz de usuario, muestra un cuadro de mensaje que muestra la pila de llamadas con números de archivo y línea. El cuadro de mensaje contiene tres botones: Anular, Reintentar e Omitir. Al hacer clic en el botón Anular , finaliza la aplicación. Al hacer clic en Reintentar , se le envía al código del depurador si la aplicación se ejecuta en un depurador o ofrece abrir un depurador si no lo está. Al hacer clic en Omitir , continúa con la siguiente instrucción en el código.

Nota:

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener. Si no DefaultTraceListener está en la Listeners colección, no se muestra el cuadro de mensaje. DefaultTraceListener Se puede quitar llamando al Clear método en la Listeners propiedad (System.Diagnostics.Trace.Listeners.Clear()). En el caso de las aplicaciones de .NET Framework, también puede usar el <elemento clear> y el elemento remove> en el< archivo de configuración de la aplicación.

En el caso de las aplicaciones de .NET Framework, puede cambiar el comportamiento de en el archivo de DefaultTraceListener configuración que corresponde al nombre de la aplicación. En este archivo, puede habilitar y deshabilitar el cuadro de mensaje de aserción o establecer la DefaultTraceListener.LogFileName propiedad . El archivo de configuración debe tener el formato siguiente:

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Consulte también

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute