Partilhar via


Trace.Assert Método

Definição

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

Origem:
Trace.cs
Origem:
Trace.cs
Origem:
Trace.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("TRACE")]
public static void Assert (bool condition);
[<System.Diagnostics.Conditional("TRACE")>]
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

Exemplos

O exemplo a seguir cria um índice para uma matriz. Em seguida, alguma ação é executada que define o valor do índice. Em seguida, o código chama Assert para verificar se o valor do índice é válido. Se não for válido, o gerará a Assert pilha de chamadas.

protected:
   // Create an index for an array.
   int index;

   void Method()
   {
      // Perform some action that sets the index.
      // Test that the index value is valid.
      #if defined(TRACE)
      Trace::Assert( index > -1 );
      #endif
   }
// Create an index for an array.
int index;

void Method()
{
    // Perform some action that sets the index.

    // Test that the index value is valid.
    Trace.Assert(index > -1);
}
' Create an index for an array.
Protected index As Integer    

Protected Sub Method()
    ' Perform some action that sets the index.
    ' Test that the index value is valid. 
    Trace.Assert(index > -1)
End Sub

Comentários

Use o Trace.Assert método se você quiser fazer declarações em builds de versão. O Debug.Assert método funciona apenas em builds de depuraçã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(Boolean) 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 um TraceListener ou removendo um 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

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>  
    <switches>  
      <add name="mySwitch" value="4"/>  
    </switches>  
    <trace autoflush="false" indentsize="4"/>  
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>  
  </system.diagnostics>  
</configuration>  

Confira também

Aplica-se a

Assert(Boolean, String)

Origem:
Trace.cs
Origem:
Trace.cs
Origem:
Trace.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("TRACE")]
public static void Assert (bool condition, string? message);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string message);
[<System.Diagnostics.Conditional("TRACE")>]
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

Exemplos

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

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

    // Perform some processing.
}
Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null")

    ' Perform some processing.
End Sub

Comentários

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

Normalmente, o Assert(Boolean, String) método é usado para identificar erros lógicos durante o desenvolvimento do programa. Assert(Boolean, String) 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.

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

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>  
    <switches>  
      <add name="mySwitch" value="4"/>  
    </switches>  
    <trace autoflush="false" indentsize="4"/>  
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>  
  </system.diagnostics>  
</configuration>  

Confira também

Aplica-se a

Assert(Boolean, String, String)

Origem:
Trace.cs
Origem:
Trace.cs
Origem:
Trace.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("TRACE")]
public static void Assert (bool condition, string? message, string? detailMessage);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string message, string detailMessage);
[<System.Diagnostics.Conditional("TRACE")>]
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

Exemplos

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

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
      #if defined(TRACE)
      Trace::Assert( type != nullptr, "Type parameter is null", "Can't get object for null type" );
      #endif
      
      // Perform some processing.
   }
public static void MyMethod(Type type, Type baseType)
{
    Trace.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)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null", _
        "Can't get object for null type")

    ' Perform some processing.
End Sub

Comentários

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

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.

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

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>  
    <switches>  
      <add name="mySwitch" value="4"/>  
    </switches>  
    <trace autoflush="false" indentsize="4"/>  
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>  
  </system.diagnostics>  
</configuration>  

Confira também

Aplica-se a