Debug.WriteLineIf Método

Definição

Espaço de Nomes:: System.Diagnostics

Assemblagens:: System.dll, System.Diagnostics.Debug.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Diagnostics.Debug.dll

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.

Escreve informação sobre a depuração para os ouvintes de traços na Listeners coleção se uma condição for true.

Sobrecargas

Name	Description
WriteLineIf(Boolean, Object, String)	Escreve um nome de categoria e o valor do método do objeto ToString() para os ouvintes de traços na Listeners coleção se uma condição for `true`.
WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler)	Escreve uma mensagem para os ouvintes de traços na Listeners coleção se uma condição especificada for `true`.
WriteLineIf(Boolean, Object)	Escreve o valor do método do ToString() objeto para os ouvintes de traços na Listeners coleção se uma condição for `true`.
WriteLineIf(Boolean, String)	Escreve uma mensagem para os ouvintes de traços na Listeners coleção se uma condição for `true`.
WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler, String)	Escreve um nome de categoria e uma mensagem para os ouvintes de traços na Listeners coleção se uma condição especificada for `true`.
WriteLineIf(Boolean, String, String)	Escreve um nome de categoria e uma mensagem para os ouvintes de traços na Listeners coleção se uma condição for `true`.

WriteLineIf(Boolean, Object, String)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Escreve um nome de categoria e o valor do método do objeto ToString() para os ouvintes de traços na Listeners coleção se uma condição for true.

public:
 static void WriteLineIf(bool condition, System::Object ^ value, System::String ^ category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, object value, string category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, object? value, string? category);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * obj * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, value As Object, category As String)

Parâmetros

condition: Boolean

A expressão condicional para avaliar. Se a condição for true, o nome e o valor da categoria são escritos para os ouvintes de traços na coleção.

value: Object

Um objeto cujo nome é enviado para o Listeners.

category: String

Um nome de categoria usado para organizar a saída.

Atributos: ConditionalAttribute

Exemplos

O exemplo seguinte cria um TraceSwitch .generalSwitch Este interruptor está definido fora do exemplo de código.

Se o interruptor estiver definido para ou TraceLevelError superior, o exemplo envia a primeira mensagem de erro para o Listeners. Para informações sobre como adicionar um ouvinte à Listeners coleção, consulte a TraceListenerCollection aula.

Então, se o TraceLevel for definido para Verbose, o exemplo gera a segunda mensagem de erro na mesma linha da primeira mensagem. Um terminador de linha segue a segunda mensagem.

// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(Object myObject, string category)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "Invalid object for category. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, myObject, category);
}

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object, category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "Invalid object for category. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, myObject, category)
End Sub

Observações

Por defeito, a saída é escrita numa instância de DefaultTraceListener.

O category parâmetro pode ser usado para agrupar mensagens de saída.

Este método chama o WriteLine método do ouvinte de traços.

Notas para Herdeiros

Pode minimizar a penalização de desempenho de instrumentar a sua aplicação usando If...Then instruções em vez de instruções WriteLineIf(Boolean, String) específicas. Os dois exemplos de código seguintes enviam a mesma mensagem de depuração. No entanto, o primeiro exemplo é muito mais rápido quando o traçado está desligado, porque se mySwitch.TraceError avalia para false, não se chama WriteLine(String). O segundo exemplo chama WriteLineIf(Boolean, String)sempre , mesmo quando mySwitch.TraceError é false e não é produzida nenhuma saída de traçado. Isto pode resultar na execução desnecessária de código arbitrariamente complexo.

Primeiro exemplo:

if(mySwitch.TraceError)
    Debug.WriteLine("aNumber = " + aNumber + " out of range");

Segundo exemplo:

Debug.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Ver também

Aplica-se a

WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Escreve uma mensagem para os ouvintes de traços na Listeners coleção se uma condição especificada for true.

public:
 static void WriteLineIf(bool condition, System::Diagnostics::Debug::WriteIfInterpolatedStringHandler % message);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, ref System.Diagnostics.Debug.WriteIfInterpolatedStringHandler message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * WriteIfInterpolatedStringHandler -> unit

Public Shared Sub WriteLineIf (condition As Boolean, ByRef message As Debug.WriteIfInterpolatedStringHandler)

Parâmetros

condition: Boolean

A expressão condicional para avaliar. Se a condição for true, a mensagem é escrita para os ouvintes de traços na coleção.

message: Debug.WriteIfInterpolatedStringHandler

A mensagem para escrever.

Atributos: ConditionalAttribute

Observações

Esta sobrecarga foi introduzida no .NET 6 para melhorar o desempenho. Em comparação com as sobrecargas que ocupam um String parâmetro, esta sobrecarga só avalia quaisquer itens de formatação de strings interpolados se a mensagem for necessária.

Por defeito, a saída é escrita numa instância de DefaultTraceListener.

Este método chama o TraceListener.WriteLine método do ouvinte de traços.

Ver também

Aplica-se a

WriteLineIf(Boolean, Object)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Escreve o valor do método do ToString() objeto para os ouvintes de traços na Listeners coleção se uma condição for true.

public:
 static void WriteLineIf(bool condition, System::Object ^ value);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, object value);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, object? value);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * obj -> unit

Public Shared Sub WriteLineIf (condition As Boolean, value As Object)

Parâmetros

condition: Boolean

A expressão condicional para avaliar. Se a condição for true, o valor é escrito para os ouvintes de traços na coleção.

value: Object

Um objeto cujo nome é enviado para o Listeners.

Atributos: ConditionalAttribute

Exemplos

O exemplo seguinte cria um TraceSwitch .generalSwitch Este interruptor está definido fora do exemplo de código.

Então, se for TraceLevel definido para Verbose, o exemplo gera o nome do objeto na mesma linha da primeira mensagem. Um terminador de linha segue a segunda mensagem.

// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(Object myObject)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "Invalid object. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, myObject);
}

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "Invalid object. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, myObject)
End Sub

Observações

Por defeito, a saída é escrita numa instância de DefaultTraceListener.

Este método chama o WriteLine método do ouvinte de traços.

Notas para Herdeiros

Primeiro exemplo:

if(mySwitch.TraceError)
    Debug.WriteLine("aNumber = " + aNumber + " out of range");

Segundo exemplo:

Debug.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Ver também

Aplica-se a

WriteLineIf(Boolean, String)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Escreve uma mensagem para os ouvintes de traços na Listeners coleção se uma condição for true.

public:
 static void WriteLineIf(bool condition, System::String ^ message);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, string message);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, string? message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, message As String)

Parâmetros

condition: Boolean

A expressão condicional para avaliar. Se a condição for true, a mensagem é escrita para os ouvintes de traços na coleção.

message: String

A mensagem para escrever.

Atributos: ConditionalAttribute

Exemplos

O exemplo seguinte cria um TraceSwitch .generalSwitch Este interruptor está definido fora do exemplo de código.

Então, se o TraceLevel for definido para Verbose, o exemplo gera a segunda mensagem de erro na mesma linha da primeira mensagem. Um terminador de linha segue a segunda mensagem.

// Class-level declaration.
// Create a TraceSwitch.
TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static void MyErrorMethod()
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.");
}

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod()
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "My error message. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.")
End Sub

Observações

Por defeito, a saída é escrita numa instância de DefaultTraceListener.

Este método chama o TraceListener.WriteLine método do ouvinte de traços.

Notas para Herdeiros

Primeiro exemplo:

if(mySwitch.TraceError)
    Debug.WriteLine("aNumber = " + aNumber + " out of range");

Segundo exemplo:

Debug.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Ver também

Aplica-se a

WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler, String)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Escreve um nome de categoria e uma mensagem para os ouvintes de traços na Listeners coleção se uma condição especificada for true.

public:
 static void WriteLineIf(bool condition, System::Diagnostics::Debug::WriteIfInterpolatedStringHandler % message, System::String ^ category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, ref System.Diagnostics.Debug.WriteIfInterpolatedStringHandler message, string? category);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * WriteIfInterpolatedStringHandler * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, ByRef message As Debug.WriteIfInterpolatedStringHandler, category As String)

Parâmetros

condition: Boolean

A expressão condicional para avaliar. Se a condição for true, a mensagem e o nome da categoria são escritos para os ouvintes de traços na coleção.

message: Debug.WriteIfInterpolatedStringHandler

A mensagem para escrever.

category: String

Um nome de categoria usado para organizar a saída.

Atributos: ConditionalAttribute

Observações

Por defeito, a saída é escrita numa instância de DefaultTraceListener.

O category parâmetro pode ser usado para agrupar mensagens de saída.

Este método chama o TraceListener.WriteLine método do ouvinte de traços.

Ver também

Aplica-se a

WriteLineIf(Boolean, String, String)

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Origem:: Debug.cs

Escreve um nome de categoria e uma mensagem para os ouvintes de traços na Listeners coleção se uma condição for true.

public:
 static void WriteLineIf(bool condition, System::String ^ message, System::String ^ category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, string message, string category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLineIf(bool condition, string? message, string? category);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLineIf : bool * string * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, message As String, category As String)

Parâmetros

condition: Boolean

A expressão condicional para avaliar. Se a condição for true, a mensagem e o nome da cateogria são escritos para os ouvintes de traços na coleção.

message: String

A mensagem para escrever.

category: String

Um nome de categoria usado para organizar a saída.

Atributos: ConditionalAttribute

Exemplos

O exemplo seguinte cria um TraceSwitch .generalSwitch Este interruptor está definido fora do exemplo de código.

Então, se o TraceLevel for definido para Verbose, o exemplo gera a segunda mensagem de erro e o category na mesma linha da primeira mensagem. Um terminador de linha segue a segunda mensagem.

// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(string category)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.", category);
}

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "My error message. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.", category)
End Sub

Observações

Por defeito, a saída é escrita numa instância de DefaultTraceListener.

O category parâmetro pode ser usado para agrupar mensagens de saída.

Este método chama o TraceListener.WriteLine método do ouvinte de traços.

Notas para Herdeiros

Primeiro exemplo:

if(mySwitch.TraceError)
    Debug.WriteLine("aNumber = " + aNumber + " out of range");

Segundo exemplo:

Debug.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Ver também

Aplica-se a

Comentários

Esta página foi útil?