Debug.Write メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
デバッグに関する情報を、Listeners コレクション内のトレース リスナーに書き込みます。
オーバーロード
Write(String, String) |
カテゴリ名とメッセージを、Listeners コレクション内のトレース リスナーに書き込みます。 |
Write(Object, String) |
Listeners コレクション内のトレース リスナーに、カテゴリ名とオブジェクトの ToString() メソッドの値を書き込みます。 |
Write(String) |
Listeners コレクション内のトレース リスナーにメッセージを書き込みます。 |
Write(Object) |
オブジェクトの ToString() メソッドの値を、Listeners コレクション内のトレース リスナーに書き込みます。 |
Write(String, String)
- ソース:
- Debug.cs
- ソース:
- Debug.cs
- ソース:
- Debug.cs
カテゴリ名とメッセージを、Listeners コレクション内のトレース リスナーに書き込みます。
public:
static void Write(System::String ^ message, System::String ^ category);
[System.Diagnostics.Conditional("DEBUG")]
public static void Write (string message, string category);
[System.Diagnostics.Conditional("DEBUG")]
public static void Write (string? message, string? category);
[<System.Diagnostics.Conditional("DEBUG")>]
static member Write : string * string -> unit
Public Shared Sub Write (message As String, category As String)
パラメーター
- message
- String
書き込むメッセージ。
- category
- String
出力を整理するために使用されるカテゴリ名。
- 属性
例
次の例では、generalSwitch
という名前の TraceSwitch を作成します。 このスイッチは、コード サンプルの外部で設定されます。
スイッチが TraceLevelError
以上に設定されている場合、最初のエラー メッセージが Listenersに出力されます。
Listeners コレクションにリスナーを追加する方法については、TraceListenerCollection クラスを参照してください。
次に、TraceLevel が Verbose
に設定されている場合、2 番目のエラー メッセージを最初のメッセージと同じ行に出力します。 2 番目のメッセージの後に行ターミネータが続きます。
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General","Entire Application" );
public:
static void MyErrorMethod( Object^ myObject, String^ category )
{
// Write the message if the TraceSwitch level is set to Error or higher.
if ( generalSwitch->TraceError )
{
#if defined(DEBUG)
Debug::Write( myObject, category );
#endif
}
// Write a second message if the TraceSwitch level is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
#if defined(DEBUG)
Debug::Write( " Object is not valid for this category." );
#endif
}
}
// 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.
if (generalSwitch.TraceError)
Debug.Write(myObject, category);
// Write a second message if the TraceSwitch level is set to Verbose.
if (generalSwitch.TraceVerbose)
Debug.WriteLine(" 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 Error or higher.
If generalSwitch.TraceError Then
Debug.Write(myObject, category)
End If
' Write a second message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Debug.WriteLine(" Object is not valid for this category.")
End If
End Sub
注釈
既定では、出力は DefaultTraceListenerのインスタンスに書き込まれます。
出力メッセージをグループ化するには、category
パラメーターを使用します。
このメソッドは、トレース リスナーの Write メソッドを呼び出します。
こちらもご覧ください
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
適用対象
Write(Object, String)
- ソース:
- Debug.cs
- ソース:
- Debug.cs
- ソース:
- Debug.cs
Listeners コレクション内のトレース リスナーに、カテゴリ名とオブジェクトの ToString() メソッドの値を書き込みます。
public:
static void Write(System::Object ^ value, System::String ^ category);
[System.Diagnostics.Conditional("DEBUG")]
public static void Write (object value, string category);
[System.Diagnostics.Conditional("DEBUG")]
public static void Write (object? value, string? category);
[<System.Diagnostics.Conditional("DEBUG")>]
static member Write : obj * string -> unit
Public Shared Sub Write (value As Object, category As String)
パラメーター
- category
- String
出力を整理するために使用されるカテゴリ名。
- 属性
例
次の例では、generalSwitch
という名前の TraceSwitch を作成します。 このスイッチは、コード サンプルの外部で設定されます。
スイッチが TraceLevelError
以上に設定されている場合、最初のエラー メッセージが Listenersに出力されます。
Listeners コレクションにリスナーを追加する方法については、TraceListenerCollection クラスを参照してください。
次に、TraceLevel が Verbose
に設定されている場合、2 番目のエラー メッセージを最初のメッセージと同じ行に出力します。 2 番目のメッセージの後に行ターミネータが続きます。
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General","Entire Application" );
public:
static void MyErrorMethod( Object^ myObject, String^ category )
{
// Write the message if the TraceSwitch level is set to Error or higher.
if ( generalSwitch->TraceError )
{
#if defined(DEBUG)
Debug::Write( myObject, category );
#endif
}
// Write a second message if the TraceSwitch level is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
#if defined(DEBUG)
Debug::Write( " Object is not valid for this category." );
#endif
}
}
// 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.
if (generalSwitch.TraceError)
Debug.Write(myObject, category);
// Write a second message if the TraceSwitch level is set to Verbose.
if (generalSwitch.TraceVerbose)
Debug.WriteLine(" 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 Error or higher.
If generalSwitch.TraceError Then
Debug.Write(myObject, category)
End If
' Write a second message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Debug.WriteLine(" Object is not valid for this category.")
End If
End Sub
注釈
既定では、出力は DefaultTraceListenerのインスタンスに書き込まれます。
出力メッセージをグループ化するには、category
パラメーターを使用します。
このメソッドは、トレース リスナーの Write メソッドを呼び出します。
こちらもご覧ください
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
適用対象
Write(String)
- ソース:
- Debug.cs
- ソース:
- Debug.cs
- ソース:
- Debug.cs
Listeners コレクション内のトレース リスナーにメッセージを書き込みます。
public:
static void Write(System::String ^ message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Write (string message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Write (string? message);
[<System.Diagnostics.Conditional("DEBUG")>]
static member Write : string -> unit
Public Shared Sub Write (message As String)
パラメーター
- message
- String
書き込むメッセージ。
- 属性
例
次の例では、generalSwitch
という名前の TraceSwitch を作成します。 このスイッチは、コード サンプルの外部で設定されます。
スイッチが TraceLevelError
以上に設定されている場合、最初のエラー メッセージが Listenersに出力されます。
Listeners コレクションにリスナーを追加する方法については、TraceListenerCollection クラスを参照してください。
次に、TraceLevel が Verbose
に設定されている場合、2 番目のエラー メッセージを最初のメッセージと同じ行に出力します。 2 番目のメッセージの後に行ターミネータが続きます。
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General","Entire Application" );
public:
static void MyErrorMethod( Object^ myObject, String^ category )
{
// Write the message if the TraceSwitch level is set to Error or higher.
if ( generalSwitch->TraceError )
{
#if defined(DEBUG)
Debug::Write( myObject, category );
#endif
}
// Write a second message if the TraceSwitch level is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
#if defined(DEBUG)
Debug::Write( " Object is not valid for this category." );
#endif
}
}
// 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.
if (generalSwitch.TraceError)
Debug.Write(myObject, category);
// Write a second message if the TraceSwitch level is set to Verbose.
if (generalSwitch.TraceVerbose)
Debug.WriteLine(" 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 Error or higher.
If generalSwitch.TraceError Then
Debug.Write(myObject, category)
End If
' Write a second message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Debug.WriteLine(" Object is not valid for this category.")
End If
End Sub
注釈
既定では、出力は DefaultTraceListenerのインスタンスに書き込まれます。
このメソッドは、トレース リスナーの Write メソッドを呼び出します。
こちらもご覧ください
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
適用対象
Write(Object)
- ソース:
- Debug.cs
- ソース:
- Debug.cs
- ソース:
- Debug.cs
オブジェクトの ToString() メソッドの値を、Listeners コレクション内のトレース リスナーに書き込みます。
public:
static void Write(System::Object ^ value);
[System.Diagnostics.Conditional("DEBUG")]
public static void Write (object value);
[System.Diagnostics.Conditional("DEBUG")]
public static void Write (object? value);
[<System.Diagnostics.Conditional("DEBUG")>]
static member Write : obj -> unit
Public Shared Sub Write (value As Object)
パラメーター
- 属性
例
次の例では、generalSwitch
という名前の TraceSwitch を作成します。 このスイッチは、コード サンプルの外部で設定されます。
スイッチが TraceLevelError
以上に設定されている場合、最初のエラー メッセージが Listenersに出力されます。
Listeners コレクションにリスナーを追加する方法については、TraceListenerCollection クラスを参照してください。
次に、TraceLevel が Verbose
に設定されている場合、2 番目のエラー メッセージを最初のメッセージと同じ行に出力します。 2 番目のメッセージの後に行ターミネータが続きます。
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General","Entire Application" );
public:
static void MyErrorMethod( Object^ myObject, String^ category )
{
// Write the message if the TraceSwitch level is set to Error or higher.
if ( generalSwitch->TraceError )
{
#if defined(DEBUG)
Debug::Write( myObject, category );
#endif
}
// Write a second message if the TraceSwitch level is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
#if defined(DEBUG)
Debug::Write( " Object is not valid for this category." );
#endif
}
}
// 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.
if (generalSwitch.TraceError)
Debug.Write(myObject, category);
// Write a second message if the TraceSwitch level is set to Verbose.
if (generalSwitch.TraceVerbose)
Debug.WriteLine(" 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 Error or higher.
If generalSwitch.TraceError Then
Debug.Write(myObject, category)
End If
' Write a second message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Debug.WriteLine(" Object is not valid for this category.")
End If
End Sub
注釈
既定では、出力は DefaultTraceListenerのインスタンスに書き込まれます。
このメソッドは、トレース リスナーの Write メソッドを呼び出します。
こちらもご覧ください
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
適用対象
.NET