Debug.Write メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Runtime.dll

デバッグについての情報を Listeners コレクションのトレース リスナーに書き込みます。

オーバーロード

Write(String, String)	カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。
Write(Object, String)	カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。
Write(String)	Listeners コレクションのトレース リスナーにメッセージを書き込みます。
Write(Object)	オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

Write(String, String)

ソース:

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")>]
static member Write : string * string -> unit

Public Shared Sub Write (message As String, category As String)

パラメーター

message

String

書き込むメッセージ。

category

String

出力を編成するために使用するカテゴリ名。

属性

ConditionalAttribute

例

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

スイッチが 以上に 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

カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

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")>]
static member Write : obj * string -> unit

Public Shared Sub Write (value As Object, category As String)

パラメーター

value

Object

名前が Listeners に送信されるオブジェクト。

category

String

出力を編成するために使用するカテゴリ名。

属性

ConditionalAttribute

例

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

スイッチが 以上に 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

Listeners コレクションのトレース リスナーにメッセージを書き込みます。

public:
 static void Write(System::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

書き込むメッセージ。

属性

ConditionalAttribute

例

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

スイッチが 以上に 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

オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。

public:
 static void Write(System::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)

パラメーター

value

Object

名前が Listeners に送信されるオブジェクト。

属性

ConditionalAttribute

例

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

スイッチが 以上に 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