Trace.Assert Método

Definição

Espaço de Nomes:: System.Diagnostics

Assemblagem:: System.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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)

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("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 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. Depois, é realizada uma ação que define o valor do índice. De seguida, as chamadas Assert de código para verificar se o valor do índice é válido. Se não for válida, a Assert pilha de chamadas é gerada.

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

Observações

Usa o Trace.Assert método se quiseres fazer asserções em versões de release. O Debug.Assert método funciona apenas em builds de depuração. 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(Boolean) 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

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>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </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("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 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 o type passado for null, o Assert gera uma mensagem.

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

Observações

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

Note

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </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("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 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 o type passado for null, o Assert gera uma mensagem.

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

Observações

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.

Note

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

Ver também

Aplica-se a

Comentários

Esta página foi útil?