Debug.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, Debug+AssertInterpolatedStringHandler)

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)

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, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

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, String, String, Object[])

Comprueba una condición; si esta es false, muestra dos mensajes (simple y con formato) y presenta un cuadro de mensaje con la pila de llamadas.

Assert(Boolean)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

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

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition);

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, se realiza alguna acción para establecer el valor del índice y, a continuación, se llama Assert a para confirmar que el valor del índice es válido. Si no es válido, Assert genera la pila de llamadas.

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

// Perform some action that sets the index.
index = -40;

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

Comentarios

De forma predeterminada, el método Debug.Assert solo funciona en compilaciones de depuración. Use el Trace.Assert método si desea realizar aserciones en compilaciones de versió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 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

Windows 8.x las aplicaciones no admiten cuadros de diálogo modales, por lo que se comportan igual en modo de interfaz de usuario y no en modo de interfaz de usuario. El mensaje se escribe en los agentes de escucha de seguimiento activos en modo de depuración o no se escribe ningún mensaje en modo de versión.

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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Consulte también

Se aplica a

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

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.

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

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
Debug.AssertInterpolatedStringHandler

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

Atributos

Comentarios

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

De forma predeterminada, el método Debug.Assert solo funciona en compilaciones de depuración. Use el Trace.Assert método si desea realizar aserciones en compilaciones de versió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 desarrollo del programa. Assert 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 <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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Consulte también

Se aplica a

Assert(Boolean, String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

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.

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

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 type es null, Assert genera un mensaje.

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

    // Perform some processing.
}

Comentarios

De forma predeterminada, el método Debug.Assert solo funciona en compilaciones de depuración. Use el Trace.Assert método si desea realizar aserciones en compilaciones de versió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 desarrollo del programa. Assert 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 <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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Consulte también

Se aplica a

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

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.

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

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
Debug.AssertInterpolatedStringHandler

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

detailMessage
Debug.AssertInterpolatedStringHandler

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

Atributos

Comentarios

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

De forma predeterminada, el método Debug.Assert solo funciona en compilaciones de depuración. Use el Trace.Assert método si desea realizar aserciones en compilaciones de versió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 desarrollo del programa. Assert 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 <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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Consulte también

Se aplica a

Assert(Boolean, String, String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

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.

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

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 type es null, Assert genera dos mensajes.

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

    // Perform some processing.
}

Comentarios

De forma predeterminada, el método Debug.Assert solo funciona en compilaciones de depuración. Use el Trace.Assert método si desea realizar aserciones en compilaciones de versió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 <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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Consulte también

Se aplica a

Assert(Boolean, String, String, Object[])

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

Comprueba una condición; si esta es false, muestra dos mensajes (simple y con formato) y presenta un cuadro de mensaje con la pila de llamadas.

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message, string detailMessageFormat, params object[] args);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message, string detailMessageFormat, params object?[] args);

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.

detailMessageFormat
String

Cadena de formato compuesto que se enviará a la colección Listeners. Este mensaje contiene texto mezclado con cero o varios elementos de formato, que corresponden a objetos de la matriz args.

args
Object[]

Matriz de objetos que contiene cero o más objetos a los que se va a aplicar formato.

Atributos

Comentarios

Este método usa la característica de formato compuesto de .NET para convertir el valor de un objeto en su representación de texto e insertar esa representación en una cadena. La cadena resultante se envía a la Listeners colección.

De forma predeterminada, el método Debug.Assert solo funciona en compilaciones de depuración. Use el Trace.Assert método si desea realizar aserciones en compilaciones de versió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, Object[]) desarrollo del programa. Assert evalúa la condición. Si el resultado es false, String.Format(String, Object[]) se llama al método y la detailMessageFormat cadena y args la matriz se pasan como parámetros. Assert(Boolean, String, String, Object[]) a continuación, envía el mensaje de texto especificado y el mensaje de texto con formato 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 <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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Se aplica a