Trace.Assert Método

Referência

Definição

Namespace:: System.Diagnostics

Assembly:: System.Diagnostics.TraceSource.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, 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)

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: 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, a Assert pilha de chamadas será gerada.

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

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

Para .NET Framework aplicativos, você pode alterar o comportamento do arquivo de DefaultTraceListener configuração que corresponde ao nome do aplicativo. Neste 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)

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: ConditionalAttribute

Exemplos

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

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

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 ou removendo um TraceListener da Listeners coleção.

Observação

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

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: ConditionalAttribute

Exemplos

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

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

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 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 Abortar 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 não DefaultTraceListener estiver na Listeners coleção, a caixa de mensagem não será exibida. O DefaultTraceListener método pode ser removido chamando o Clear Listeners método na propriedade (System.Diagnostics.Trace.Listeners.Clear()). Para aplicativos .NET Framework, você também pode usar o <clear> elemento e o <remove> elemento no arquivo de configuração do aplicativo.

<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

Trace.Assert Método

Definição

Sobrecargas

Assert(Boolean)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

Assert(Boolean, String)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

Assert(Boolean, String, String)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais