Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

Debug.Assert (Método) (Boolean)

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

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)

[ConditionalAttribute("DEBUG")]
public static void Assert(
	bool condition
)

Parámetros

condition
Tipo: System.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.

De forma predeterminada, el método Debug.Assert sólo trabaja en compilaciones de depuración. Utilice el método Trace.Assert 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 Assert(Boolean) se utiliza para identificar errores lógicos durante el desarrollo de programas. Assert evalúa la condición. Si el resultado es false, se envía un mensajes de error a la colección Listeners. Para personalizar este comportamiento, agregue o quite la clase TraceListener de la colección de Listeners.

Cuando la aplicación se ejecuta en modo de interfaz de usuario, aparece 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 y Omitir. Al hacer clic en el botón Anular, se finaliza la aplicación. Al hacer clic en Reintentar, se le envía al código en el depurador si la aplicación se está ejecutando en un depurador, o se ofrece abrir un depurador si no lo está. Al hacer clic en Omitir se continúa con la instrucción máquina siguiente en el código.

NotaNota

La presentación del cuadro de mensaje depende de la presencia del DefaultTraceListener. Si DefaultTraceListener no está en la colección de Listeners, no se muestra el cuadro de mensaje. DefaultTraceListener se puede eliminar mediante Elemento <clear> de <listeners> de <trace> y Elemento <remove> de <listeners> de <trace>, o llamando al método Clear de la propiedad Listeners (System.Diagnostics.Trace.Listeners.Clear()).

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

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

En el siguiente ejemplo se crea un índice para una matriz, se realiza alguna acción para establecer el valor del índice y a continuación, se llama a Assert para confirmar que el valor de índice es válido. Si no es válido, Assert envía la pila de llamadas.


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

 // Perform some action that sets the index.

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


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Compatible con:

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: