Debug.WriteIf メソッド
条件が true の場合、デバッグについての情報を Listeners コレクションのトレース リスナに書き込みます。
オーバーロードの一覧
条件が true の場合、オブジェクトの ToString メソッドの値を、 Listeners コレクションのトレース リスナに書き込みます。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Shared Sub WriteIf(Boolean, Object)
条件が true の場合、メッセージを Listeners コレクションのトレース リスナに書き込みます。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Shared Sub WriteIf(Boolean, String)
条件が true の場合、カテゴリ名およびオブジェクトの ToString メソッドの値を、 Listeners コレクションのトレース リスナに書き込みます。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Shared Sub WriteIf(Boolean, Object, String)
[JScript] public static function WriteIf(Boolean, Object, String);
条件が true の場合、カテゴリ名とメッセージを Listeners コレクションのトレース リスナに書き込みます。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Shared Sub WriteIf(Boolean, String, String)
[JScript] public static function WriteIf(Boolean, String, String);
使用例
generalSwitch
という名前の TraceSwitch を作成する例を次に示します。このスイッチは、コード サンプルの外部で設定されています。
スイッチが TraceLevel Verbose に設定されている場合は、この例では最初のエラー メッセージが Listeners に出力されます。 Listeners コレクションにリスナを追加する方法については、 TraceListenerCollection クラスのトピックを参照してください。
TraceLevel が Error 以上に設定されている場合、この例では、最初のメッセージと同じ行に 2 番目のエラー メッセージが表示されます。第 2 のメッセージの後に行終端記号があります。
' 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.
Debug.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.
Debug.WriteLineIf(generalSwitch.TraceError, " Please use a different category.")
End Sub 'MyErrorMethod
[C#]
// 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.
Debug.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.
Debug.WriteLineIf(generalSwitch.TraceError, " Please use a different category.");
}
[C++]
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch* generalSwitch = new TraceSwitch(S"General", S"Entire Application");
public:
static void MyErrorMethod(Object* myObject, String* category) {
// Write the message if the TraceSwitch level is set to Verbose.
Debug::WriteIf(generalSwitch->TraceVerbose, String::Concat( myObject, S" is not a valid object for category: " ), category);
// Write a second message if the TraceSwitch level is set to Error or higher.
Debug::WriteLineIf(generalSwitch->TraceError, S" Please use a different category.");
}
[JScript]
// Class level declaration.
// Create a TraceSwitch.
static var generalSwitch : TraceSwitch = new TraceSwitch("General", "Entire Application");
static public function MyErrorMethod(myObject : Object, category : String) {
// Write the message if the TraceSwitch level is set to Verbose.
Debug.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.
Debug.WriteLineIf(generalSwitch.TraceError, " Please use a different category.");
}