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

 

Publicado: octubre de 2016

Comprueba una condición; Si la condición es false, muestra dos mensajes (simples y con formato) y presenta 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 detailMessageFormat,
	params object[] args
)

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.

detailMessageFormat
Type: System.String

La cadena de formato compuesto (vea comentarios) para enviar a la Listeners colección. Este mensaje contiene texto combinado con cero o más elementos de formato, que corresponden a objetos en el args matriz.

args
Type: System.Object[]

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

Este método utiliza el de .NET Framework para convertir el valor de un objeto en su representación de texto e incrustar dicha representación en una cadena. La cadena resultante se envía a la Listeners colección.

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, Object[]) 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, el String.Format(String, Object[]) se llama al método y el detailMessageFormat cadena y args 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 para el 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>

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 4.0
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar: