Debug.Assert Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Comprueba una condición; si la condición es false
, genera mensajes y muestra un cuadro de mensaje que muestra la pila de llamadas.
Assert(Boolean) |
Comprueba una condición; si la condición es |
Assert(Boolean, Debug+AssertInterpolatedStringHandler) |
Comprueba una condición; si la condición es |
Assert(Boolean, String) |
Comprueba una condición; si la condición es |
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler) |
Comprueba una condición; si la condición es |
Assert(Boolean, String, String) |
Comprueba una condición; si la condición es |
Assert(Boolean, String, String, Object[]) |
Comprueba una condición; si esta es |
- 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.
public:
static void Assert(bool condition);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition);
[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool -> unit
Public Shared Sub Assert (condition As Boolean)
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 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, 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
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Se aplica a
- 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.
public:
static void Assert(bool condition, System::Diagnostics::Debug::AssertInterpolatedStringHandler % message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message);
[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * AssertInterpolatedStringHandler -> unit
Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler)
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.
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
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Se aplica a
- 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.
public:
static void Assert(bool condition, System::String ^ message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message);
[<System.Diagnostics.Conditional("DEBUG")>]
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. Si la condición es true
, no se envía el mensaje especificado y no se muestra el cuadro de mensaje.
- Atributos
Ejemplos
En el ejemplo siguiente se comprueba si el type
parámetro es válido. Si type
es null
, Assert genera un mensaje.
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, 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
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Se aplica a
- 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.
public:
static void Assert(bool condition, System::Diagnostics::Debug::AssertInterpolatedStringHandler % message, System::Diagnostics::Debug::AssertInterpolatedStringHandler % detailMessage);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler detailMessage);
[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool * AssertInterpolatedStringHandler * AssertInterpolatedStringHandler -> unit
Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler, ByRef detailMessage As Debug.AssertInterpolatedStringHandler)
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.
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
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Se aplica a
- 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.
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);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message, string? detailMessage);
[<System.Diagnostics.Conditional("DEBUG")>]
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. Si la condición es true
, no se envían los mensaje especificados y no se muestra el cuadro de mensaje.
- Atributos
Ejemplos
En el ejemplo siguiente se comprueba si el type
parámetro es válido. Si type
es null
, Assert genera dos mensajes.
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, 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
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
Se aplica a
- 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.
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);
[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message, string detailMessageFormat, params object?[] args);
[<System.Diagnostics.Conditional("DEBUG")>]
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. Si la condición es true
, no se envían los mensaje especificados y no se muestra el cuadro de mensaje.
- 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
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: