Trace.Assert Método

Definición

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

Sobrecargas

Assert(Boolean)

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

Assert(Boolean, String)

Comprueba 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 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)

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

public:
 static void Assert(bool condition);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition);
[<System.Diagnostics.Conditional("TRACE")>]
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 el mensaje de error y no se muestra el cuadro de mensaje.

Atributos

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 del índice es válido. Si no es válido, genera Assert la pila de llamadas.

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

   void Method()
   {
      // Perform some action that sets the index.
      // Test that the index value is valid.
      #if defined(TRACE)
      Trace::Assert( index > -1 );
      #endif
   }
// 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, vea Aserciones en el código administrado.

Normalmente, el método se usa para identificar errores lógicos durante el Assert(Boolean) 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 un TraceListener elemento a, 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 <clear> elemento y el elemento en el <remove> 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

Se aplica a

Assert(Boolean, String)

Comprueba 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);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string message);
[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String)

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

El mensaje que se va a enviar a la colección Listeners.

Atributos

Ejemplos

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

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
     #if defined(TRACE)
     Trace::Assert( type != nullptr, "Type parameter is null" );
     #endif
      
      // Perform some processing.
   }
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, vea Aserciones en el código administrado.

Normalmente, el método se usa para identificar errores lógicos durante el Assert(Boolean, String) 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 un TraceListener elemento a, 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 <clear> elemento y el elemento en el <remove> 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

Se aplica a

Assert(Boolean, String, String)

Comprueba 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")]
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 mensaje especificados y no se muestra el cuadro de mensaje.

message
String

El mensaje que se va a enviar a la colección Listeners.

detailMessage
String

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

Atributos

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 )
   {
      #if defined(TRACE)
      Trace::Assert( type != nullptr, "Type parameter is null", "Can't get object for null type" );
      #endif
      
      // Perform some processing.
   }
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, vea Aserciones en el código administrado.

Normalmente, el método se usa para identificar errores lógicos durante el Assert(Boolean, String, String) 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 un TraceListener elemento a, 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 <clear> elemento y el elemento en el <remove> 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 assert 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

Se aplica a