Trace.WriteLineIf メソッド (Boolean, Object)

[アーティクル]
03/28/2008

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

<Conditional("TRACE")>
Overloads Public Shared Sub WriteLineIf( _   ByVal condition As Boolean, _   ByVal value As Object _)
[C#]
[Conditional("TRACE")]
public static void WriteLineIf(boolcondition,objectvalue);
[C++]
[Conditional("TRACE")]
public: static void WriteLineIf(boolcondition,Object* value);
[JScript]
public
   Conditional("TRACE")
static function WriteLineIf(condition : Boolean,value : Object);

パラメータ

condition
メッセージを書き込む場合は true 。それ以外の場合は false 。
value
名前が Listeners に送信される Object 。

解説

既定では、出力は DefaultTraceListener のインスタンスに書き込まれます。

このメソッドは、トレースリスナの WriteLine メソッドを呼び出します。

実装時の注意: WriteLineIf ステートメントの代わりに If...Then ステートメントを使用することによって、アプリケーション導入によるパフォーマンスの低下を最小限にとどめることができます。次の 2 つのコード例は、同じデバッグメッセージを送信します。しかし、トレースがオフである場合は、最初の例の方がはるかに高速です。これは、 mySwitch.TraceError が false と評価されると、 WriteLine を呼び出さないからです。第 2 の例では、 mySwitch.TraceError が false でトレース出力が生成されない場合でも、常に WriteLineIf が呼び出されます。これにより、必要以上に複雑なコードが、不必要に実行される可能性があります。

最初の例。

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

第 2 の例。

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

使用例

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

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

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

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


[C#] 
// 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, "Invalid object. ");
 
    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, myObject);
 }


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


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

function MyErrorMethod(errorObject : Object){
  // Write a message if the TraceSwitch level is set to Error or higher.
  Trace.WriteLineIf(generalSwitch.TraceError, errorObject)

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

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

次の方法で共有

Trace.WriteLineIf メソッド (Boolean, Object)

パラメータ

解説

使用例

必要条件

参照

その他のリソース