Debug.Assert Método

Definição

Espaço de Nomes:
System.Diagnostics
Assemblagens:
System.dll, System.Diagnostics.Debug.dll
Assemblagem:
System.dll
Assemblagem:
System.Diagnostics.Debug.dll
Assemblagem:
netstandard.dll

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

Sobrecargas

Name Description
Assert(Boolean)

Verifica uma condição; Se a condição for false, exibe uma caixa de mensagem que mostra a pilha de chamadas.
Assert(Boolean, String)

Verifica uma condição; Se a condição for false, gera uma mensagem especificada e exibe uma caixa de mensagens que mostra a pilha de chamadas.
Assert(Boolean, String, String)

Verifica uma condição; Se a condição for false, gera duas mensagens especificadas e exibe uma caixa de mensagens que mostra a pilha de chamadas.
Assert(Boolean, String, String, Object[])

Verifica uma condição; Se a condição for false, gera duas mensagens (simples e formatadas) e exibe uma caixa de mensagens que mostra a pilha de chamadas.

Assert(Boolean)

Verifica uma condição; Se a condição for false, exibe 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 para avaliar. Se a condição for true, não é enviada uma mensagem de falha e a caixa de mensagem não é apresentada.

Atributos
ConditionalAttribute

Exemplos

O exemplo seguinte cria um índice para um array, realiza alguma ação para definir o valor do índice e depois liga Assert para confirmar que o valor do índice é válido. Se não for válido, Assert gera a pilha de chamadas.

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

Observações

Por defeito, o Debug.Assert método só funciona em builds de depuração. Usa o Trace.Assert método se quiseres fazer asserções em versões de release. Para obter mais informações, consulte asserções no código gerenciado.

Normalmente, o Assert(Boolean) método é usado para identificar erros lógicos durante o desenvolvimento de programas. Assert Avalia a condição. Se o resultado for false, envia uma mensagem de falha para a Listeners coleção. Pode personalizar este comportamento adicionando TraceListener ou removendo um da Listeners coleção.

Quando a aplicação corre em modo de interface de utilizador, apresenta uma caixa de mensagens que mostra a pilha de chamadas com números de ficheiro e linha. A caixa de mensagens contém três botões: Abortar, Retentar e Ignorar. Clicar no botão Abortar termina a aplicação. Clicar em Retentar envia-te para o código do depurador se a tua aplicação estiver a correr num depurador, ou oferece-te para abrir um depurador se não estiver. Clicar em Ignorar continua com a próxima instrução no código.

Note

As aplicações do Windows 8.x não suportam caixas de diálogo modais, por isso comportam-se da mesma forma tanto no modo de interface de utilizador como no modo não-interface de utilizador. A mensagem é escrita para os ouvintes ativos do traço em modo de depuração, ou nenhuma mensagem é escrita em modo de lançamento.

Note

A visualizaçã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 é exibida. O DefaultTraceListener pode ser removido chamando o Clear método na Listeners propriedade (System.Diagnostics.Trace.Listeners.Clear()). Para .NET aplicações Framework, também pode usar o elemento <clear> e o elemento <remove> no ficheiro de configuração da sua aplicação.

Para .NET aplicações Framework, podes alterar o comportamento do DefaultTraceListener no ficheiro de configuração que corresponde ao nome da tua aplicação. Neste ficheiro, pode ativar e desativar a caixa de mensagem assert ou definir a DefaultTraceListener.LogFileName propriedade. O ficheiro de configuração deve ser formatado da seguinte forma:

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

Ver também

Aplica-se a

Assert(Boolean, String)

Verifica uma condição; Se a condição for false, gera uma mensagem especificada e exibe uma caixa de mensagens 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")>]
static member Assert : bool * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String)

Parâmetros

condition
Boolean

A expressão condicional para avaliar. Se a condição for true, a mensagem especificada não é enviada e a caixa de mensagem não é apresentada.

message
String

A mensagem a enviar à Listeners coleção.

Atributos
ConditionalAttribute

Exemplos

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

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

Observações

Por defeito, o Debug.Assert método só funciona em builds de depuração. Usa o Trace.Assert método se quiseres fazer asserções em versões de release. Para obter mais informações, consulte asserções no código gerenciado.

Normalmente, o Assert método é usado para identificar erros lógicos durante o desenvolvimento de programas. Assert Avalia a condição. Se o resultado for false, envia a mensagem de diagnóstico especificada para a Listeners coleção. Pode personalizar este comportamento adicionando TraceListener ou removendo um da Listeners coleção.

Quando a aplicação corre em modo de interface de utilizador, apresenta uma caixa de mensagens que mostra a pilha de chamadas com números de ficheiro e linha. A caixa de mensagens contém três botões: Abortar, Retentar e Ignorar. Clicar no botão Abortar termina a aplicação. Clicar em Retentar envia-te para o código do depurador se a tua aplicação estiver a correr num depurador, ou oferece-te para abrir um depurador se não estiver. Clicar em Ignorar continua com a próxima instrução no código.

Note

A visualizaçã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 é exibida. O DefaultTraceListener pode ser removido chamando o Clear método na Listeners propriedade (System.Diagnostics.Trace.Listeners.Clear()). Para .NET aplicações Framework, também pode usar o elemento <clear> e o elemento <remove> no ficheiro de configuração da sua aplicação.

Para .NET aplicações Framework, podes alterar o comportamento do DefaultTraceListener no ficheiro de configuração que corresponde ao nome da tua aplicação. Neste ficheiro, pode ativar e desativar a caixa de mensagem assert ou definir a DefaultTraceListener.LogFileName propriedade. O ficheiro de configuração deve ser formatado da seguinte forma:

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

Ver também

Aplica-se a

Assert(Boolean, String, String)

Verifica uma condição; Se a condição for false, gera duas mensagens especificadas e exibe uma caixa de mensagens 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")>]
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 para avaliar. Se a condição for true, as mensagens especificadas não são enviadas e a caixa de mensagens não é apresentada.

message
String

A mensagem a enviar à Listeners coleção.

detailMessage
String

A mensagem detalhada para enviar à Listeners coleção.

Atributos
ConditionalAttribute

Exemplos

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

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

Observações

Por defeito, o Debug.Assert método só funciona em builds de depuração. Usa o Trace.Assert método se quiseres fazer asserções em versões de release. Para obter mais informações, consulte asserções no código gerenciado.

Normalmente, o Assert(Boolean, String, String) método é usado para identificar erros lógicos durante o desenvolvimento de programas. Assert Avalia a condição. Se o resultado for false, envia a mensagem de diagnóstico especificada e a mensagem detalhada para a Listeners coleção. Pode personalizar este comportamento adicionando TraceListener ou removendo um da Listeners coleção.

Quando a aplicação corre em modo de interface de utilizador, apresenta uma caixa de mensagens que mostra a pilha de chamadas com números de ficheiro e linha. A caixa de mensagens contém três botões: Abortar, Retentar e Ignorar. Clicar no botão Abortar termina a aplicação. Clicar em Retentar envia-te para o código do depurador se a tua aplicação estiver a correr num depurador, ou oferece-te para abrir um depurador se não estiver. Clicar em Ignorar continua com a próxima instrução no código.

Note

A visualizaçã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 é exibida. O DefaultTraceListener pode ser removido chamando o Clear método na Listeners propriedade (System.Diagnostics.Trace.Listeners.Clear()). Para .NET aplicações Framework, também pode usar o elemento <clear> e o elemento <remove> no ficheiro de configuração da sua aplicação.

Para .NET aplicações Framework, podes alterar o comportamento do DefaultTraceListener no ficheiro de configuração que corresponde ao nome da tua aplicação. Neste ficheiro, pode ativar e desativar a caixa de mensagem assert ou definir a DefaultTraceListener.LogFileName propriedade. O ficheiro de configuração deve ser formatado da seguinte forma:

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

Ver também

Aplica-se a

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

Verifica uma condição; Se a condição for false, gera duas mensagens (simples e formatadas) e exibe uma caixa de mensagens 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")>]
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 para avaliar. Se a condição for true, as mensagens especificadas não são enviadas e a caixa de mensagens não é apresentada.

message
String

A mensagem a enviar à Listeners coleção.

detailMessageFormat
String

A cadeia de formato composto para enviar à Listeners coleção. Esta mensagem contém texto misturado com zero ou mais itens de formato, que correspondem a objetos no args array.

args
Object[]

Um array de objetos que contém zero ou mais objetos para formatar.

Atributos
ConditionalAttribute

Observações

Este método utiliza a funcionalidade de formatação composta .NET para converter o valor de um objeto para a sua representação em texto e incorporar essa representação numa cadeia. A cadeia resultante é enviada para a Listeners coleção.

Por defeito, o Debug.Assert método só funciona em builds de depuração. Usa o Trace.Assert método se quiseres fazer asserções em versões de release. Para obter mais informações, consulte asserções no código gerenciado.

Normalmente, o Assert(Boolean, String, String, Object[]) método é usado para identificar erros lógicos durante o desenvolvimento de programas. Assert Avalia a condição. Se o resultado for false, O String.Format(String, Object[]) método é chamado e a detailMessageFormat cadeia e args o array são passados como parâmetros. Assert(Boolean, String, String, Object[]) depois envia a mensagem de texto especificada e a mensagem de texto formatada para a Listeners coleção. Pode personalizar este comportamento adicionando TraceListener ou removendo um da Listeners coleção.

Quando a aplicação corre em modo de interface de utilizador, apresenta uma caixa de mensagens que mostra a pilha de chamadas com números de ficheiro e linha. A caixa de mensagens contém três botões: Abortar, Retentar e Ignorar. Clicar no botão Abortar termina a aplicação. Clicar em Retentar envia-te para o código do depurador se a tua aplicação estiver a correr num depurador, ou oferece-te para abrir um depurador se não estiver. Clicar em Ignorar continua com a próxima instrução no código.

Note

A visualização da caixa de mensagens depende da presença do DefaultTraceListener. Se o DefaultTraceListener não estiver na Listeners coleção, a caixa de mensagem não é exibida. O DefaultTraceListener pode ser removido chamando o Clear método na Listeners propriedade (System.Diagnostics.Trace.Listeners.Clear()). Para .NET aplicações Framework, também pode usar o elemento <clear> e o elemento <remove> no ficheiro de configuração da sua aplicação.

Para .NET aplicações Framework, podes alterar o comportamento do DefaultTraceListener no ficheiro de configuração que corresponde ao nome da tua aplicação. Neste ficheiro, pode ativar e desativar a caixa de mensagem assert ou definir a DefaultTraceListener.LogFileName propriedade. O ficheiro de configuração deve ser formatado da seguinte forma:

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

Aplica-se a