Trace.WriteIf Метод

Определение

Пространство имен:

System.Diagnostics

Сборки:

netstandard.dll, System.Diagnostics.TraceSource.dll

Записывает сведения о трассировке в прослушиватели трассировки в Listeners коллекции, если условие .true

Перегрузки

Имя	Описание
WriteIf(Boolean, String, String)	Записывает имя категории и сообщение в прослушиватели трассировки в Listeners коллекции, если условие.true
WriteIf(Boolean, Object, String)	Записывает имя категории и значение метода объекта ToString() в прослушиватели трассировки в коллекции, Listeners если условие равно true.
WriteIf(Boolean, Object)	Записывает значение метода объекта ToString() в прослушиватели трассировки в Listeners коллекции, если условие .true
WriteIf(Boolean, String)	Записывает сообщение в прослушиватели трассировки в коллекции, Listeners если условие равно true.

WriteIf(Boolean, String, String)

Исходный код:

Trace.cs

Записывает имя категории и сообщение в прослушиватели трассировки в Listeners коллекции, если условие.true

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

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

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

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

Параметры

condition

Boolean

true , чтобы сообщение было записано; falseв противном случае .

message

String

Сообщение для записи.

category

String

Имя категории, используемое для упорядочивания выходных данных.

Атрибуты

ConditionalAttribute

Примеры

В следующем примере создается именованный TraceSwitchgeneralSwitchобъект. Этот параметр задается за пределами примера кода.

Если для параметра задано TraceLevelVerboseзначение, в примере выводится первое сообщение об ошибке Listeners. Сведения о добавлении прослушивателя в Listeners коллекцию см. в TraceListenerCollection классе.

Затем, если TraceLevel задано Error значение или выше, в примере выводится второе сообщение об ошибке в той же строке, что и первое сообщение. За вторым сообщением следует терминатор строки.

// 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 Verbose.
    Trace.WriteIf(generalSwitch.TraceVerbose, myObject.ToString() +
       " is not a valid object for category: ", category);

    // Write a second message if the TraceSwitch level is set to Error or higher.
    Trace.WriteLineIf(generalSwitch.TraceError, " Please use a different 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 Verbose.
    Trace.WriteIf(generalSwitch.TraceVerbose, myObject.ToString() & _
        " is not a valid object for category: ", category)
    
    ' Write a second message if the TraceSwitch level is set to Error or higher.
    Trace.WriteLineIf(generalSwitch.TraceError, _
        " Please use a different category.")
End Sub

Комментарии

По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.

Параметр category можно использовать для группировки выходных сообщений.

Этот метод вызывает Write метод прослушивателя трассировки.

Примечания для тех, кто наследует этот метод

Вы можете свести к минимуму производительность инструментирования приложения с помощью If...Then инструкций вместо инструкций using WriteIf(Boolean, String) . В следующих двух примерах кода отправляется одно и то же сообщение отладки. Однако первый пример гораздо быстрее при отключении трассировки, так как при mySwitch.TraceError оценке false не вызывается Write(String). Второй пример всегда вызывается WriteIf(Boolean, String), даже если mySwitch.TraceError выходные false данные трассировки не создаются. Это может привести к ненужным выполнению произвольно сложного кода.

Первый пример

if(mySwitch.TraceError)
    Trace.Write("aNumber = " + aNumber + " out of range");

Второй пример

Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

См. также раздел

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

WriteIf(Boolean, Object, String)

Исходный код:

Trace.cs

Записывает имя категории и значение метода объекта ToString() в прослушиватели трассировки в коллекции, Listeners если условие равно true.

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

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

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

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

Параметры

condition

Boolean

true , чтобы сообщение было записано; falseв противном случае .

value

Object

Имя Object которого отправляется в Listeners.

category

String

Имя категории, используемое для упорядочивания выходных данных.

Атрибуты

ConditionalAttribute

Примеры

В следующем примере создается именованный TraceSwitchgeneralSwitchобъект. Этот параметр задается за пределами примера кода.

Если для параметра задано TraceLevelVerboseзначение, в примере выводится имя и myObject имя category объектаListeners. Сведения о добавлении прослушивателя в Listeners коллекцию см. в TraceListenerCollection классе.

Затем, если TraceLevel задано Error значение или выше, в примере выводится второе сообщение об ошибке в той же строке, что и первое сообщение. За вторым сообщением следует терминатор строки.

// 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 Verbose.
    Trace.WriteIf(generalSwitch.TraceVerbose, myObject, category);

    // Write a second message if the TraceSwitch level is set to Error or higher.
    Trace.WriteLineIf(generalSwitch.TraceError, " Object is not valid for this 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 Verbose.
    Trace.WriteIf(generalSwitch.TraceVerbose, myObject, category)
    
    ' Write a second message if the TraceSwitch level is set to Error or higher.
    Trace.WriteLineIf(generalSwitch.TraceError, _
        " Object is not valid for this category.")
End Sub

Комментарии

По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.

Параметр category можно использовать для группировки выходных сообщений.

Этот метод вызывает Write метод прослушивателя трассировки.

Примечания для тех, кто наследует этот метод

Вы можете свести к минимуму производительность инструментирования приложения с помощью If...Then инструкций вместо инструкций using WriteIf(Boolean, String) . В следующих двух примерах кода отправляется одно и то же сообщение отладки. Однако первый пример гораздо быстрее при отключении трассировки, так как при mySwitch.TraceError оценке false не вызывается Write(String). Второй пример всегда вызывается WriteIf(Boolean, String), даже если mySwitch.TraceError выходные false данные трассировки не создаются. Это может привести к ненужным выполнению произвольно сложного кода.

Первый пример

if(mySwitch.TraceError)
    Trace.Write("aNumber = " + aNumber + " out of range");

Второй пример

Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

См. также раздел

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

WriteIf(Boolean, Object)

Исходный код:

Trace.cs

Записывает значение метода объекта ToString() в прослушиватели трассировки в Listeners коллекции, если условие .true

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

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

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

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

Параметры

condition

Boolean

true , чтобы сообщение было записано; falseв противном случае .

value

Object

Имя Object которого отправляется в Listeners.

Атрибуты

ConditionalAttribute

Примеры

В следующем примере создается именованный TraceSwitchgeneralSwitchобъект. Этот параметр задается за пределами примера кода.

Если для параметра задано TraceLevelError значение или выше, в примере выводится первое имя параметра Listenersзначения. Сведения о добавлении прослушивателя в Listeners коллекцию см. в TraceListenerCollection классе.

Затем, если TraceLevel задано Verboseзначение, в примере выводится сообщение в той же строке, что и первое сообщение. За вторым сообщением следует терминатор строки.

// 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.
    Trace.WriteIf(generalSwitch.TraceError, myObject);

    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, " is not a valid value for this method.");
 }

' 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.
    Trace.WriteIf(generalSwitch.TraceError, myObject)
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, _
        " is not a valid value for this method.")
End Sub

Комментарии

По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.

Этот метод вызывает Write метод прослушивателя трассировки.

Примечания для тех, кто наследует этот метод

Вы можете свести к минимуму производительность инструментирования приложения с помощью If...Then инструкций вместо инструкций using WriteIf(Boolean, String) . В следующих двух примерах кода отправляется одно и то же сообщение отладки. Однако первый пример гораздо быстрее при отключении трассировки, так как при mySwitch.TraceError оценке false не вызывается Write(String). Второй пример всегда вызывается WriteIf(Boolean, String), даже если mySwitch.TraceError выходные false данные трассировки не создаются. Это может привести к ненужным выполнению произвольно сложного кода.

Первый пример

if(mySwitch.TraceError)
    Trace.Write("aNumber = " + aNumber + " out of range");

Второй пример

Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

См. также раздел

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

WriteIf(Boolean, String)

Исходный код:

Trace.cs

Записывает сообщение в прослушиватели трассировки в коллекции, Listeners если условие равно true.

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

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

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

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

Параметры

condition

Boolean

true , чтобы сообщение было записано; falseв противном случае .

message

String

Сообщение для записи.

Атрибуты

ConditionalAttribute

Примеры

В следующем примере создается именованный TraceSwitchgeneralSwitchобъект. Этот параметр задается за пределами примера кода.

Если для параметра задано TraceLevelError значение или выше, в примере выводится первое сообщение об ошибке Listeners. Сведения о добавлении прослушивателя в Listeners коллекцию см. в TraceListenerCollection классе.

Затем, если TraceLevel задано Verboseзначение, в примере выводится второе сообщение об ошибке в той же строке, что и первое сообщение. За вторым сообщением следует терминатор строки.

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

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

    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace.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.
    Trace.WriteIf(generalSwitch.TraceError, "My error message. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.")
End Sub

Комментарии

По умолчанию выходные данные записываются в экземпляр DefaultTraceListener.

Этот метод вызывает Write метод прослушивателя трассировки.

Примечания для тех, кто наследует этот метод

Вы можете свести к минимуму производительность инструментирования приложения с помощью If...Then инструкций вместо инструкций using WriteIf(Boolean, String) . В следующих двух примерах кода отправляется одно и то же сообщение отладки. Однако первый пример гораздо быстрее при отключении трассировки, так как при mySwitch.TraceError оценке false не вызывается Write(String). Второй пример всегда вызывается WriteIf(Boolean, String), даже если mySwitch.TraceError выходные false данные трассировки не создаются. Это может привести к ненужным выполнению произвольно сложного кода.

Первый пример

if(mySwitch.TraceError)
    Trace.Write("aNumber = " + aNumber + " out of range");

Второй пример

Trace.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

См. также раздел

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