Debug.Write メソッド

リファレンス

定義

名前空間:: System.Diagnostics

アセンブリ:: System.Diagnostics.Debug.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

Write(String, String)

カテゴリ名とメッセージを 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

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

属性: 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 トレースリスナーのメソッドを呼び出します。

こちらもご覧ください

適用対象

Write(Object, String)

カテゴリ名とオブジェクトの 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")]
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. このスイッチは、コードサンプルの外部で設定されます。

   // 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 トレースリスナーのメソッドを呼び出します。

こちらもご覧ください

適用対象

Write(String)

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

書き込むメッセージ。

属性: ConditionalAttribute

例

次の例では、名前付き TraceSwitch generalSwitch. このスイッチは、コードサンプルの外部で設定されます。

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

   // 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 トレースリスナーのメソッドを呼び出します。

こちらもご覧ください

適用対象

Write(Object)

オブジェクトの 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)

パラメーター

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 トレースリスナーのメソッドを呼び出します。

こちらもご覧ください

適用対象