Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Debug.Assert (Boolean, String, String)

 

Publicado: octubre de 2016

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.

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

[ConditionalAttribute("DEBUG")]
public static void Assert(
	bool condition,
	string message,
	string detailMessage
)

Parámetros

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

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

detailMessage
Type: System.String

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

De forma predeterminada, la Debug.Assert método funciona sólo en compilaciones de depuración. Utilice la Trace.Assert método si desea realizar aserciones en versión crea. Para obtener más información, consulta Aserciones en el código administrado.

Normalmente, el Assert(Boolean, String, String) método se utiliza para identificar errores lógicos durante el desarrollo del programa. Assert evalúa la condición. Si el resultado es false, envía los mensajes de diagnóstico específico y el mensaje detallado a la Listeners colección. Puede personalizar este comportamiento mediante la adición de un TraceListener o quite uno de los 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 línea y archivo. El cuadro de mensaje contiene tres botones: Anular, Reintentar, y omitir. Haga clic en el Anular botón finaliza la aplicación. Haga clic en Reintentar le envía al código en el depurador si la aplicación se ejecuta en un depurador u ofrece abrir un depurador si no lo está. Haga clic en omitir continúa con la siguiente instrucción en el código.

System_CAPS_noteNota

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

Puede cambiar el comportamiento de la DefaultTraceListener en el archivo de 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 el DefaultTraceListener.LogFileName propiedad. El archivo de configuración debería tener el siguiente formato:

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

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.
 }

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar: