Debug.Assert Método

Definición

Espacio de nombres:: System.Diagnostics

Ensamblados:: System.dll, System.Diagnostics.Debug.dll

Ensamblados:: netstandard.dll, System.Runtime.dll

Ensamblado:: System.Diagnostics.Debug.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

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 si hay una condición; si la condición es false, genera mensajes y muestra un cuadro de mensaje que muestra la pila de llamadas.

Sobrecargas

Nombre	Description
Assert(Boolean)	Comprueba si hay una condición; si la condición es `false`, muestra un cuadro de mensaje que muestra la pila de llamadas.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	Comprueba si hay 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.
Assert(Boolean, String)	Comprueba si hay 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.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	Comprueba si hay 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.
Assert(Boolean, String, String)	Comprueba si hay 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.
Assert(Boolean, String, String, Object[])	Comprueba si hay una condición; si la condición es `false`, genera dos mensajes (simple y con formato) y muestra un cuadro de mensaje que muestra la pila de llamadas.

Assert(Boolean)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Comprueba si hay una condición; si la condición es false, muestra 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")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool -> unit

[<System.Diagnostics.Conditional("DEBUG")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
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 un mensaje de error y no se muestra el cuadro de mensaje.

Atributos: ConditionalAttribute OverloadResolutionPriorityAttribute

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 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 Debug.Assert método 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, consulte Aserciones en código administrado.

Normalmente, el Assert(Boolean) método se usa para identificar errores lógicos durante el 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 a TraceListener 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:

Las aplicaciones de Windows 8.x 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

Se aplica a

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Comprueba si hay 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.

message: Debug.AssertInterpolatedStringHandler

Mensaje que se va a enviar a la Listeners colección.

Atributos: ConditionalAttribute

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.

Normalmente, el Assert método se usa para identificar errores lógicos durante el 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 a TraceListener o quitando uno de la Listeners colección.

Nota:

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

Consulte también

Se aplica a

Assert(Boolean, String)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Comprueba si hay 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 = default);

[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)

Public Shared Sub Assert (condition As Boolean, Optional message As String = Nothing)

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.

message: String

Mensaje que se va a enviar a la Listeners colección.

Atributos: ConditionalAttribute

Ejemplos

En el ejemplo siguiente se comprueba si el type parámetro es válido. Si type es null, Assert genera un mensaje.

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

Nota:

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

Consulte también

Se aplica a

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Comprueba si hay 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.

message: Debug.AssertInterpolatedStringHandler

Mensaje que se va a enviar a la Listeners colección.

detailMessage: Debug.AssertInterpolatedStringHandler

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

Atributos: ConditionalAttribute

Comentarios

Nota:

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

Consulte también

Se aplica a

Assert(Boolean, String, String)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Comprueba si hay 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 mensajes especificados y no se muestra el cuadro de mensaje.

message: String

Mensaje que se va a enviar a la Listeners colección.

detailMessage: String

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

Atributos: ConditionalAttribute

Ejemplos

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

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

Normalmente, el Assert(Boolean, String, String) método se usa para identificar errores lógicos durante el 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 a TraceListener o quitando uno de la Listeners colección.

Nota:

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

Consulte también

Se aplica a

Assert(Boolean, String, String, Object[])

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

Comprueba si hay una condición; si la condición es false, genera dos mensajes (simple y con formato) y muestra un cuadro de mensaje que muestra 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 mensajes especificados y no se muestra el cuadro de mensaje.

message: String

Mensaje que se va a enviar a la Listeners colección.

detailMessageFormat: String

Cadena de formato compuesto que se va a enviar a la Listeners colección. Este mensaje contiene texto mezclado con cero o más elementos de formato, que corresponden a objetos de la args matriz.

args: Object[]

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

Atributos: ConditionalAttribute

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.

Normalmente, el Assert(Boolean, String, String, Object[]) método se usa para identificar errores lógicos durante el 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 cadena y args la detailMessageFormat 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 a TraceListener o quitando uno de la Listeners colección.

Nota:

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

Se aplica a

Comentaris

Us ha resultat útil aquesta pàgina?

Comparteix a través de

Debug.Assert Método

Definición

Sobrecargas

Assert(Boolean)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Parámetros

Comentarios

Consulte también

Se aplica a

Assert(Boolean, String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Parámetros

Comentarios

Consulte también

Se aplica a

Assert(Boolean, String, String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Assert(Boolean, String, String, Object[])

Parámetros

Comentarios

Se aplica a

Comentaris