Trace.WriteLineIf メソッド

条件が true の場合、トレースについての情報を Listeners コレクションのトレース リスナに書き込みます。

オーバーロードの一覧

条件が true の場合、オブジェクトの ToString メソッドの値を Listeners コレクションのトレース リスナに書き込みます。

[Visual Basic] Overloads Public Shared Sub WriteLineIf(Boolean, Object)

[C#] public static void WriteLineIf(bool, object);

[C++] public: static void WriteLineIf(bool, Object*);

[JScript] public static function WriteLineIf(Boolean, Object);

条件が true の場合、メッセージを Listeners コレクションのトレース リスナに書き込みます。

[Visual Basic] Overloads Public Shared Sub WriteLineIf(Boolean, String)

[C#] public static void WriteLineIf(bool, string);

[C++] public: static void WriteLineIf(bool, String*);

[JScript] public static function WriteLineIf(Boolean, String);

条件が true の場合、カテゴリ名およびオブジェクトの ToString メソッドの値を、 Listeners コレクションのトレース リスナに書き込みます。

[Visual Basic] Overloads Public Shared Sub WriteLineIf(Boolean, Object, String)

[C#] public static void WriteLineIf(bool, object, string);

[C++] public: static void WriteLineIf(bool, Object*, String*);

[JScript] public static function WriteLineIf(Boolean, Object, String);

条件が true の場合、カテゴリ名とメッセージを Listeners レクションのトレース リスナに書き込みます。

[Visual Basic] Overloads Public Shared Sub WriteLineIf(Boolean, String, String)

[C#] public static void WriteLineIf(bool, string, string);

[C++] public: static void WriteLineIf(bool, String*, String*);

[JScript] public static function WriteLineIf(Boolean, String, String);

使用例

generalSwitch という名前の TraceSwitch を作成する例を次に示します。このスイッチは、コード サンプルの外部で設定されています。

スイッチが TraceLevel Error 以上に設定されている場合、この例では、最初のエラー メッセージが Listeners に出力されます。 Listeners コレクションにリスナを追加する方法については、 TraceListenerCollection クラスのトピックを参照してください。

TraceLevel が Verbose に設定されている場合、この例では、最初のメッセージと同じ行に 2 番目のエラー メッセージと category が表示されます。2 番目のメッセージの後に行終端記号が続きます。

 
' 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.
    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.", category)
End Sub


[C#] 
// 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.
    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.", category);
 }


[C++] 
// Class-level declaration.
 // Create a TraceSwitch.
 static TraceSwitch* generalSwitch = new TraceSwitch(S"General", S"Entire Application");
 
public:
 static void MyErrorMethod(String* category) {
    // Write the message if the TraceSwitch level is set to Error or higher.
    Trace::WriteIf(generalSwitch->TraceError, S"My error message. ");
 
    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace::WriteLineIf(generalSwitch->TraceVerbose, S"My second error message.", category);
 }


[JScript] 
// Create a TraceSwitch.
var generalSwitch : TraceSwitch = new TraceSwitch("General", "Entire Application")

function MyErrorMethod(myObject : Object, category : String){
  // Write the message if the TraceSwitch level is set to Verbose.
  Trace.WriteLineIf(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.")
}

参照

Trace クラス | Trace メンバ | System.Diagnostics 名前空間