Debug.Assert Método

Referência

Definição

Namespace:: System.Diagnostics

Assembly:: System.Diagnostics.Debug.dll

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Verifica uma condição; se ela for false, gera mensagens e exibe uma caixa de mensagem que mostra a pilha de chamadas.

Sobrecargas

Assert(Boolean)	Verifica uma condição; se a condição for `false`, exibirá uma caixa de mensagem que mostra a pilha de chamadas.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	Verifica uma condição, se a condição for `false`, gerará uma mensagem especificada e exibirá uma caixa de mensagem que mostra a pilha de chamadas.
Assert(Boolean, String)	Verifica uma condição, se a condição for `false`, gerará uma mensagem especificada e exibirá uma caixa de mensagem que mostra a pilha de chamadas.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	Verifica uma condição, se a condição for `false`, gerará uma mensagem especificada e exibirá uma caixa de mensagem que mostra a pilha de chamadas.
Assert(Boolean, String, String)	Verifica uma condição. Se a condição for `false`, gerará duas mensagens especificadas e exibe uma caixa de mensagem que mostra a pilha de chamadas.
Assert(Boolean, String, String, Object[])	Verifica uma condição, se a condição for `false`, gerará duas mensagens (simples e formatadas) e exibirá uma caixa de mensagem que mostra a pilha de chamadas.

Assert(Boolean)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Verifica uma condição; se a condição for false, exibirá uma caixa de mensagem que mostra a pilha de chamadas.

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

A expressão condicional a ser avaliada. Se a condição for true, uma mensagem de falha não será enviada e a caixa de mensagem não será exibida.

Atributos: ConditionalAttribute

Exemplos

O exemplo a seguir cria um índice para uma matriz, executa alguma ação para definir o valor do índice e Assert chama para confirmar se o valor do índice é válido. Se não for válido, Assert gerará a pilha de chamadas.

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

Comentários

Por padrão, o método Debug.Assert só funciona em builds de depuração. Use o Trace.Assert método se você quiser fazer declarações em builds de versão. Para obter mais informações, confira Asserções em código gerenciado.

Normalmente, o Assert(Boolean) método é usado para identificar erros lógicos durante o desenvolvimento do programa. Assert avalia a condição. Se o resultado for false, ele enviará uma mensagem de falha para a Listeners coleção. Você pode personalizar esse comportamento adicionando ou removendo um TraceListener da Listeners coleção.

Quando o aplicativo é executado no modo de interface do usuário, ele exibe uma caixa de mensagem que mostra a pilha de chamadas com números de arquivo e linha. A caixa de mensagem contém três botões: Anular, Repetir e Ignorar. Clicar no botão Anular encerra o aplicativo. Clicar em Repetir envia você para o código no depurador se o aplicativo estiver em execução em um depurador ou se oferecer para abrir um depurador se não estiver. Clicar em Ignorar continua com a próxima instrução no código.

Observação

Windows 8.x aplicativos não dão suporte a caixas de diálogo modais, portanto, eles se comportam da mesma forma no modo de interface do usuário e no modo de interface não usuário. A mensagem é gravada nos ouvintes de rastreamento ativos no modo de depuração ou nenhuma mensagem é gravada no modo de versão.

Observação

A exibição da caixa de mensagem depende da presença do DefaultTraceListener. Se o DefaultTraceListener não estiver na Listeners coleção, a caixa de mensagem não será exibida. O DefaultTraceListener pode ser removido chamando o Clear método na Listeners propriedade (System.Diagnostics.Trace.Listeners.Clear()). Para aplicativos .NET Framework, você também pode usar o <elemento clear> e o <elemento remove> no arquivo de configuração do aplicativo.

Para aplicativos .NET Framework, você pode alterar o comportamento do DefaultTraceListener no arquivo de configuração que corresponde ao nome do aplicativo. Nesse arquivo, você pode habilitar e desabilitar a caixa de mensagem de declaração ou definir a DefaultTraceListener.LogFileName propriedade . O arquivo de configuração deve ser formatado da seguinte maneira:

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

Confira também

Aplica-se a

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Verifica uma condição, se a condição for false, gerará uma mensagem especificada e exibirá uma caixa de mensagem que mostra a pilha de chamadas.

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

A expressão condicional a ser avaliada. Se a condição for true, a mensagem especificada não será enviada e a caixa de mensagem não será exibida.

message: Debug.AssertInterpolatedStringHandler

A mensagem a ser enviada para a coleção Listeners.

Atributos: ConditionalAttribute

Comentários

Essa sobrecarga foi introduzida no .NET 6 para melhorar o desempenho. Em comparação com as sobrecargas que levam um String parâmetro, essa sobrecarga avaliará apenas quaisquer itens de formatação de cadeia de caracteres interpolada se a mensagem for necessária.

Normalmente, o Assert método é usado para identificar erros lógicos durante o desenvolvimento do programa. Assert avalia a condição. Se o resultado for false, ele enviará a mensagem de diagnóstico especificada para a Listeners coleção. Você pode personalizar esse comportamento adicionando ou removendo um TraceListener da Listeners coleção.

Observação

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

Confira também

Aplica-se a

Assert(Boolean, String)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Verifica uma condição, se a condição for false, gerará uma mensagem especificada e exibirá uma caixa de mensagem que mostra a pilha de chamadas.

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

A expressão condicional a ser avaliada. Se a condição for true, a mensagem especificada não será enviada e a caixa de mensagem não será exibida.

message: String

A mensagem a ser enviada para a coleção Listeners.

Atributos: ConditionalAttribute

Exemplos

O exemplo a seguir verifica se o type parâmetro é válido. Se type for null, Assert gerará uma mensagem.

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

Comentários

Observação

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

Confira também

Aplica-se a

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

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Verifica uma condição, se a condição for false, gerará uma mensagem especificada e exibirá uma caixa de mensagem que mostra a pilha de chamadas.

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

A expressão condicional a ser avaliada. Se a condição for true, a mensagem especificada não será enviada e a caixa de mensagem não será exibida.

message: Debug.AssertInterpolatedStringHandler

A mensagem a ser enviada para a coleção Listeners.

detailMessage: Debug.AssertInterpolatedStringHandler

A mensagem detalhada a ser enviada para a coleção Listeners.

Atributos: ConditionalAttribute

Comentários

Essa sobrecarga foi introduzida no .NET 6 para melhorar o desempenho. Em comparação com as sobrecargas que levam um String parâmetro, essa sobrecarga só avalia quaisquer itens de formatação de cadeia de caracteres interpolada se a mensagem for necessária.

Normalmente, o Assert método é usado para identificar erros lógicos durante o desenvolvimento do programa. Assert avalia a condição. Se o resultado for false, ele enviará a mensagem de diagnóstico especificada para a Listeners coleção. Você pode personalizar esse comportamento adicionando um TraceListener ou removendo um da Listeners coleção.

Observação

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

Confira também

Aplica-se a

Assert(Boolean, String, String)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Verifica uma condição. Se a condição for false, gerará duas mensagens especificadas e exibe uma caixa de mensagem que mostra a pilha de chamadas.

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

A expressão condicional a ser avaliada. Se a condição for true, as mensagens especificadas não serão enviadas e a caixa de mensagem não será exibida.

message: String

A mensagem a ser enviada para a coleção Listeners.

detailMessage: String

A mensagem detalhada a ser enviada para a coleção Listeners.

Atributos: ConditionalAttribute

Exemplos

O exemplo a seguir verifica se o type parâmetro é válido. Se type for null, Assert gerará duas mensagens.

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

Comentários

Normalmente, o Assert(Boolean, String, String) método é usado para identificar erros lógicos durante o desenvolvimento do programa. Assert avalia a condição. Se o resultado for false, ele enviará a mensagem de diagnóstico especificada e a mensagem detalhada para a Listeners coleção. Você pode personalizar esse comportamento adicionando um TraceListener ou removendo um da Listeners coleção.

Observação

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

Confira também

Aplica-se a

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

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Verifica uma condição, se a condição for false, gerará duas mensagens (simples e formatadas) e exibirá uma caixa de mensagem que mostra a pilha de chamadas.

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

A expressão condicional a ser avaliada. Se a condição for true, as mensagens especificadas não serão enviadas e a caixa de mensagem não será exibida.

message: String

A mensagem a ser enviada para a coleção Listeners.

detailMessageFormat: String

A cadeia de caracteres de formato de composição para a coleção Listeners. Essa mensagem contém texto misturado com zero ou mais itens de formato, que correspondem aos objetos na matriz args.

args: Object[]

Uma matriz de objetos que contém zero ou mais objetos a serem formatados.

Atributos: ConditionalAttribute

Comentários

Esse método usa o recurso de formatação composta do .NET para converter o valor de um objeto em sua representação de texto e inserir essa representação em uma cadeia de caracteres. A cadeia de caracteres resultante é enviada para a Listeners coleção.

Normalmente, o Assert(Boolean, String, String, Object[]) método é usado para identificar erros lógicos durante o desenvolvimento do programa. Assert avalia a condição. Se o resultado for false, o String.Format(String, Object[]) método será chamado e a cadeia de caracteres e args a detailMessageFormat matriz serão passadas como parâmetros. Assert(Boolean, String, String, Object[]) em seguida, envia a mensagem de texto especificada e a mensagem de texto formatada para a Listeners coleção. Você pode personalizar esse comportamento adicionando um TraceListener ou removendo um da Listeners coleção.

Observação

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

Aplica-se a

Debug.Assert Método

Definição

Sobrecargas

Assert(Boolean)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Parâmetros

Comentários

Confira também

Aplica-se a

Assert(Boolean, String)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Comentários

Confira também

Aplica-se a

Assert(Boolean, String, String)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Comentários

Aplica-se a

Comentários

Recursos adicionais