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.Checks for a condition; if the condition is false, outputs messages and displays a message box that shows the call stack.

Sobrecargas

Assert(Boolean)

Comprueba una condición; si la condición es false, aparece un cuadro de mensaje que muestra la pila de llamadas.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

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.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

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.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

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.Checks for a condition; if the condition is false, outputs two messages (simple and formatted) and displays a message box that shows the call stack.

Assert(Boolean)

Comprueba una condición; si la condición es false, aparece un cuadro de mensaje que muestra la pila de llamadas.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

public:
 static void Assert(bool condition);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition);
static member Assert : bool -> unit
Public Shared Sub Assert (condition As Boolean)

Parámetros

condition
Boolean

Expresión condicional que se va a evaluar.The conditional expression to evaluate. Si la condición es true, no se envía el mensaje de error y no se muestra el cuadro de mensaje.If the condition is true, a failure message is not sent and the message box is not displayed.

Atributos

Ejemplos

En el ejemplo siguiente se crea un índice para una matriz, realiza alguna acción para establecer el valor del índice y, a Assert continuación, llama a para confirmar que el valor de índice es válido.The following example creates an index for an array, performs some action to set the value of the index, and then calls Assert to confirm that the index value is valid. Si no es válido, Assert genera la pila de llamadas.If it is not valid, Assert outputs the call stack.

// Create a local value.
int index;

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

// Test that the local value is valid. 
#if defined(DEBUG)
Debug::Assert( index > -1 );
#endif
// 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);   
' Create an index for an array.
Dim index As Integer

' Perform some action that sets the index.
index = -40

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

Comentarios

De forma predeterminada, Debug.Assert el método solo funciona en las compilaciones de depuración.By default, the Debug.Assert method works only in debug builds. Use el Trace.Assert método si desea realizar aserciones en las compilaciones de versión.Use the Trace.Assert method if you want to do assertions in release builds. Para obtener más información, vea Aserciones en el código administrado.For more information, see Assertions in Managed Code.

Importante

Los Assert métodos no están disponibles para Tienda WindowsWindows Store las aplicaciones.The Assert methods are not available for Tienda WindowsWindows Store apps.

Normalmente, el Assert(Boolean) método se usa para identificar errores lógicos durante el desarrollo del programa.Typically, the Assert(Boolean) method is used to identify logic errors during program development. Assertevalúa la condición.Assert evaluates the condition. Si el resultado es false, envía un mensaje de error a la Listeners colección.If the result is false, it sends a failure message to the Listeners collection. Puede personalizar este comportamiento agregando TraceListener o quitando una de la Listeners colección.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Cuando la aplicación se ejecuta en modo de interfaz de usuario, muestra un cuadro de mensaje que muestra la pila de llamadas con los números de archivo y de línea.When the application runs in user interface mode, it displays a message box that shows the call stack with file and line numbers. El cuadro de mensaje contiene tres botones: Anular, Reintentary omitir.The message box contains three buttons: Abort, Retry, and Ignore. Al hacer **** clic en el botón anular finaliza la aplicación.Clicking the Abort button terminates the application. Al hacer clic en Reintentar , se le envía al código del depurador si la aplicación se ejecuta en un depurador, o si no se puede abrir un depurador si no lo está.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Al **** hacer clic en omitir, continúa con la siguiente instrucción del código.Clicking Ignore continues with the next instruction in the code.

Nota

Tienda Windows 8.xWindows 8.x Storelas aplicaciones no admiten cuadros de diálogo modales, de modo que se comportan igual en el modo de interfaz de usuario y en el modo de interfaz que no es de usuario.apps do not support modal dialog boxes, so they behave the same in user interface mode and non-user interface mode. 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.The message is written to the active trace listeners in debugging mode, or no message is written in release mode.

Nota

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Listeners Si no DefaultTraceListener está en la colección, no se muestra el cuadro de mensaje.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. <> Listeners System.Diagnostics.Trace.Listeners.Clear() <> Clear El puede quitarse mediante el borrado, la eliminación o llamando al método en la propiedad (). DefaultTraceListenerThe DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Puede cambiar el comportamiento de DefaultTraceListener en el archivo de configuración que se corresponde con el nombre de la aplicación.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. En este archivo, puede habilitar y deshabilitar el cuadro de mensaje de aserción o DefaultTraceListener.LogFileName establecer la propiedad.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. El archivo de configuración debe tener el formato siguiente:The configuration file should be formatted as follows:

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

Consulte también:

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.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message);
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.The conditional expression to evaluate. Si la condición es true, no se envía el mensaje especificado y no se muestra el cuadro de mensaje.If the condition is true, the specified message is not sent and the message box is not displayed.

message
String

El mensaje que se va a enviar a la colección Listeners.The message to send to the Listeners collection.

Atributos

Ejemplos

En el ejemplo siguiente se comprueba type si el parámetro es válido.The following example checks whether the type parameter is valid. Si type es null ,Assert genera un mensaje.If type is null, Assert outputs a message.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null" );
   #endif
}
public static void MyMethod(Type type, Type baseType) {
    Debug.Assert(type != null, "Type parameter is null");
 
   // Perform some processing.
 }

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Debug.Assert(Not (type Is Nothing), "Type parameter is null")
End Sub

Comentarios

De forma predeterminada, Debug.Assert el método solo funciona en las compilaciones de depuración.By default, the Debug.Assert method works only in debug builds. Use el Trace.Assert método si desea realizar aserciones en las compilaciones de versión.Use the Trace.Assert method if you want to do assertions in release builds. Para obtener más información, vea Aserciones en el código administrado.For more information, see Assertions in Managed Code.

Normalmente, el Assert método se usa para identificar errores lógicos durante el desarrollo del programa.Typically, the Assert method is used to identify logic errors during program development. Assertevalúa la condición.Assert evaluates the condition. Si el resultado es false, envía el mensaje de diagnóstico especificado a la Listeners colección.If the result is false, it sends the specified diagnostic message to the Listeners collection. Puede personalizar este comportamiento agregando TraceListener o quitando una de la Listeners colección.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Cuando la aplicación se ejecuta en modo de interfaz de usuario, muestra un cuadro de mensaje que muestra la pila de llamadas con los números de archivo y de línea.When the application runs in user interface mode, it displays a message box that shows the call stack with file and line numbers. El cuadro de mensaje contiene tres botones: Anular, Reintentary omitir.The message box contains three buttons: Abort, Retry, and Ignore. Al hacer **** clic en el botón anular finaliza la aplicación.Clicking the Abort button terminates the application. Al hacer clic en Reintentar , se le envía al código del depurador si la aplicación se ejecuta en un depurador, o si no se puede abrir un depurador si no lo está.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Al **** hacer clic en omitir, continúa con la siguiente instrucción del código.Clicking Ignore continues with the next instruction in the code.

Nota

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Listeners Si no DefaultTraceListener está en la colección, no se muestra el cuadro de mensaje.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. <> Listeners System.Diagnostics.Trace.Listeners.Clear() <> Clear El puede quitarse mediante el borrado, la eliminación o llamando al método en la propiedad (). DefaultTraceListenerThe DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Puede cambiar el comportamiento de DefaultTraceListener en el archivo de configuración que se corresponde con el nombre de la aplicación.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. En este archivo, puede habilitar y deshabilitar el cuadro de mensaje de aserción o DefaultTraceListener.LogFileName establecer la propiedad.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. El archivo de configuración debe tener el formato siguiente:The configuration file should be formatted as follows:

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

Consulte también:

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.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessage);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message, string detailMessage);
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.The conditional expression to evaluate. Si la condición es true, no se envían los mensajes especificados y no se muestra el cuadro de mensaje.If the condition is true, the specified messages are not sent and the message box is not displayed.

message
String

El mensaje que se va a enviar a la colección Listeners.The message to send to the Listeners collection.

detailMessage
String

El mensaje detallado que se va a enviar a la colección Listeners.The detailed message to send to the Listeners collection.

Atributos

Ejemplos

En el ejemplo siguiente se comprueba type si el parámetro es válido.The following example checks whether the type parameter is valid. Si type es null ,Assert genera dos mensajes.If type is null, Assert outputs two messages.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null", "Can't get object for null type" );
   #endif
}
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.
 }

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Debug.Assert( Not (type Is Nothing), "Type parameter is null", "Can't get object for null type")
    ' Perform some processing.
End Sub

Comentarios

De forma predeterminada, Debug.Assert el método solo funciona en las compilaciones de depuración.By default, the Debug.Assert method works only in debug builds. Use el Trace.Assert método si desea realizar aserciones en las compilaciones de versión.Use the Trace.Assert method if you want to do assertions in release builds. Para obtener más información, vea Aserciones en el código administrado.For more information, see Assertions in Managed Code.

Normalmente, el Assert(Boolean, String, String) método se usa para identificar errores lógicos durante el desarrollo del programa.Typically, the Assert(Boolean, String, String) method is used to identify logic errors during program development. Assertevalúa la condición.Assert evaluates the condition. Si el resultado es false, envía el mensaje de diagnóstico especificado y el mensaje detallado a Listeners la colección.If the result is false, it sends the specified diagnostic message and detailed message to the Listeners collection. Puede personalizar este comportamiento agregando TraceListener o quitando una de la Listeners colección.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Cuando la aplicación se ejecuta en modo de interfaz de usuario, muestra un cuadro de mensaje que muestra la pila de llamadas con los números de archivo y de línea.When the application runs in user interface mode, it displays a message box that shows the call stack with file and line numbers. El cuadro de mensaje contiene tres botones: Anular, Reintentary omitir.The message box contains three buttons: Abort, Retry, and Ignore. Al hacer **** clic en el botón anular finaliza la aplicación.Clicking the Abort button terminates the application. Al hacer clic en Reintentar , se le envía al código del depurador si la aplicación se ejecuta en un depurador, o si no se puede abrir un depurador si no lo está.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Al **** hacer clic en omitir, continúa con la siguiente instrucción del código.Clicking Ignore continues with the next instruction in the code.

Nota

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener.The display of the message box depends on the presence of the DefaultTraceListener. Listeners Si no DefaultTraceListener está en la colección, no se muestra el cuadro de mensaje.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. <> Listeners System.Diagnostics.Trace.Listeners.Clear() <> Clear El puede quitarse mediante el borrado, la eliminación o llamando al método en la propiedad (). DefaultTraceListenerThe DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Puede cambiar el comportamiento de DefaultTraceListener en el archivo de configuración que se corresponde con el nombre de la aplicación.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. En este archivo, puede habilitar y deshabilitar el cuadro de mensaje de aserción o DefaultTraceListener.LogFileName establecer la propiedad.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. El archivo de configuración debe tener el formato siguiente:The configuration file should be formatted as follows:

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

Consulte también:

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.Checks for a condition; if the condition is false, outputs two messages (simple and formatted) and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessageFormat, ... cli::array <System::Object ^> ^ args);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message, string detailMessageFormat, params object[] args);
static member Assert : bool * string * string * obj[] -> unit
Public Shared Sub Assert (condition As Boolean, message As String, detailMessageFormat As String, ParamArray args As Object())

Parámetros

condition
Boolean

Expresión condicional que se va a evaluar.The conditional expression to evaluate. Si la condición es true, no se envían los mensajes especificados y no se muestra el cuadro de mensaje.If the condition is true, the specified messages are not sent and the message box is not displayed.

message
String

El mensaje que se va a enviar a la colección Listeners.The message to send to the Listeners collection.

detailMessageFormat
String

Cadena de formato compuesto que se enviará a la colección Listeners.The composite format string to send to the Listeners collection. Este mensaje contiene texto mezclado con cero o varios elementos de formato, que corresponden a objetos de la matriz args.This message contains text intermixed with zero or more format items, which correspond to objects in the args array.

args
Object[]

Matriz de objetos que contiene cero o más objetos a los que se va a aplicar formato.An object array that contains zero or more objects to format.

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 incrustar esa representación en una cadena.This method uses the .NET composite formatting feature to convert the value of an object to its text representation and embed that representation in a string. La cadena resultante se envía a la Listeners colección.The resulting string is sent to the Listeners collection.

De forma predeterminada, Debug.Assert el método solo funciona en las compilaciones de depuración.By default, the Debug.Assert method works only in debug builds. Use el Trace.Assert método si desea realizar aserciones en las compilaciones de versión.Use the Trace.Assert method if you want to do assertions in release builds. Para obtener más información, vea Aserciones en el código administrado.For more information, see Assertions in Managed Code.

Normalmente, el Assert(Boolean, String, String, Object[]) método se usa para identificar errores lógicos durante el desarrollo del programa.Typically, the Assert(Boolean, String, String, Object[]) method is used to identify logic errors during program development. Assertevalúa la condición.Assert evaluates the condition. Si el resultado es false, se String.Format(String, Object[]) llama al método y la detailMessageFormat cadena y args la matriz se pasan como parámetros.If the result is false, The String.Format(String, Object[]) method is called and the detailMessageFormat string and args array are passed in as parameters. Assert(Boolean, String, String, Object[])a continuación, envía el mensaje de texto especificado y el mensaje de Listeners texto con formato a la colección.Assert(Boolean, String, String, Object[]) then sends the specified text message and the formatted text message to the Listeners collection. Puede personalizar este comportamiento agregando TraceListener o quitando una de la Listeners colección.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Cuando la aplicación se ejecuta en modo de interfaz de usuario, muestra un cuadro de mensaje que muestra la pila de llamadas con los números de archivo y de línea.When the application runs in user interface mode, it displays a message box that shows the call stack with file and line numbers. El cuadro de mensaje contiene tres botones: Anular, Reintentary omitir.The message box contains three buttons: Abort, Retry, and Ignore. Al hacer **** clic en el botón anular finaliza la aplicación.Clicking the Abort button terminates the application. Al hacer clic en Reintentar , se le envía al código del depurador si la aplicación se ejecuta en un depurador, o si no se puede abrir un depurador si no lo está.Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. Al **** hacer clic en omitir, continúa con la siguiente instrucción del código.Clicking Ignore continues with the next instruction in the code.

Nota

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener.The display of the message box is dependent on the presence of the DefaultTraceListener. Listeners Si no DefaultTraceListener está en la colección, no se muestra el cuadro de mensaje.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. <> Listeners System.Diagnostics.Trace.Listeners.Clear() <> Clear El puede quitarse mediante el borrado, la eliminación o llamando al método en la propiedad (). DefaultTraceListenerThe DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Puede cambiar el comportamiento de DefaultTraceListener en el archivo de configuración que se corresponde con el nombre de la aplicación.You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. En este archivo, puede habilitar y deshabilitar el cuadro de mensaje de aserción o DefaultTraceListener.LogFileName establecer la propiedad.In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. El archivo de configuración debe tener el formato siguiente:The configuration file should be formatted as follows:

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

Se aplica a