Trace.Assert Método

Origem:

Trace.cs

Origem:

Trace.cs

Origem:

Trace.cs

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

Atributos

ConditionalAttribute

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.

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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Origem:

Trace.cs

Origem:

Trace.cs

Origem:

Trace.cs

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

Atributos

ConditionalAttribute

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.

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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Origem:

Trace.cs

Origem:

Trace.cs

Origem:

Trace.cs

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

Atributos

ConditionalAttribute

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.

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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute