Trace.Write メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
トレースについての情報を Listeners コレクションのトレース リスナーに書き込みます。
オーバーロード
Write(Object) |
オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。 |
Write(String) |
Listeners コレクションのトレース リスナーにメッセージを書き込みます。 |
Write(Object, String) |
カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。 |
Write(String, String) |
カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。 |
Write(Object)
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
オブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。
public:
static void Write(System::Object ^ value);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (object? value);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (object value);
[<System.Diagnostics.Conditional("TRACE")>]
static member Write : obj -> unit
Public Shared Sub Write (value As Object)
パラメーター
- 属性
例
次の例では、 という名前の を TraceSwitch 作成します generalSwitch
。 このスイッチは、コード サンプルの外部で設定されます。
スイッチが 以上に TraceLevelError
設定されている場合、この例では パラメーターの名を value
に Listeners出力します。 コレクションにリスナーを追加する Listeners 方法については、 クラスを TraceListenerCollection 参照してください。
次に TraceLevel 、 が に Verbose
設定されている場合、最初のメッセージと同じ行にメッセージを出力します。 2 番目のメッセージの後に行終端記号が続きます。
// Class-level declaration.
// Create a TraceSwitch.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod( Object^ myObject )
{
#if defined(TRACE)
// Write the message if the TraceSwitch level
// is set to Error or higher.
if ( generalSwitch->TraceError )
{
Trace::Write( myObject );
}
// Write a second message if the TraceSwitch level
// is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
Trace::WriteLine( " is not a valid value for this method." );
}
#endif
}
// 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.
if(generalSwitch.TraceError)
Trace.Write(myObject);
// Write a second message if the TraceSwitch level is set to Verbose.
if(generalSwitch.TraceVerbose)
Trace.WriteLine(" is not a valid value for this method.");
}
' 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.
If generalSwitch.TraceError Then
Trace.Write(myObject)
End If
' Write a second message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Trace.WriteLine(" is not a valid value for this method.")
End If
End Sub
注釈
既定では、出力は の DefaultTraceListenerインスタンスに書き込まれます。
このメソッドは、 Write トレース リスナーの メソッドを呼び出します。
注意
ASP.NET は、Web ページ用に調整されたトレース機能を提供します。 ASP.NET ページでトレース メッセージを書き込むには、 プロパティを Page.Trace 使用します。
既定では、ASP.NET Web ページに関連付けられているコードでは、 ステートメント Trace.Write("...")
は プロパティの WritePage.Trace メソッドの呼び出しです。 Web ページで クラスを System.Diagnostics.Trace 使用するには、 などの名前空間 System.Diagnostics.Trace.Write("...")
を含める必要があります。
こちらもご覧ください
適用対象
Write(String)
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
Listeners コレクションのトレース リスナーにメッセージを書き込みます。
public:
static void Write(System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (string? message);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (string message);
[<System.Diagnostics.Conditional("TRACE")>]
static member Write : string -> unit
Public Shared Sub Write (message As String)
パラメーター
- message
- String
書き込むメッセージ。
- 属性
例
次の例では、 という名前の を TraceSwitch 作成します generalSwitch
。 このスイッチは、コード サンプルの外部で設定されます。
スイッチが 以上に TraceLevelError
設定されている場合、最初のエラー メッセージが に出力されます Listeners。 コレクションにリスナーを追加する Listeners 方法については、 クラスを TraceListenerCollection 参照してください。
次に TraceLevel 、 が に Verbose
設定されている場合、2 番目のエラー メッセージは最初のメッセージと同じ行に出力されます。 2 番目のメッセージの後に行終端記号が続きます。
// Class-level declaration.
// Create a TraceSwitch.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod()
{
// Write the message if the TraceSwitch level is set
// to Error or higher.
if ( generalSwitch->TraceError )
{
Trace::Write( "My error message. " );
}
// Write a second message if the TraceSwitch level is set
// to Verbose.
if ( generalSwitch->TraceVerbose )
{
Trace::WriteLine( "My second error message." );
}
}
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");
static public void MyErrorMethod() {
// Write the message if the TraceSwitch level is set to Error or higher.
if(generalSwitch.TraceError)
Trace.Write("My error message. ");
// Write a second message if the TraceSwitch level is set to Verbose.
if(generalSwitch.TraceVerbose)
Trace.WriteLine("My second error message.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")
Public Shared Sub MyErrorMethod()
' Write the message if the TraceSwitch level is set to Error or higher.
If generalSwitch.TraceError Then
Trace.Write("My error message. ")
End If
' Write a second message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Trace.WriteLine("My second error message.")
End If
End Sub
注釈
既定では、出力は の DefaultTraceListenerインスタンスに書き込まれます。
このメソッドは、 Write トレース リスナーの メソッドを呼び出します。
注意
ASP.NET は、Web ページ用に調整されたトレース機能を提供します。 ASP.NET ページでトレース メッセージを書き込むには、 プロパティを Page.Trace 使用します。
既定では、ASP.NET Web ページに関連付けられているコードでは、 ステートメント Trace.Write("...")
は プロパティの WritePage.Trace メソッドの呼び出しです。 Web ページで クラスを System.Diagnostics.Trace 使用するには、 などの名前空間 System.Diagnostics.Trace.Write("...")
を含める必要があります。
こちらもご覧ください
適用対象
Write(Object, String)
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
カテゴリ名とオブジェクトの ToString() メソッドの値を Listeners コレクションのトレース リスナーに書き込みます。
public:
static void Write(System::Object ^ value, System::String ^ category);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (object? value, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (object value, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member Write : obj * string -> unit
Public Shared Sub Write (value As Object, category As String)
パラメーター
- category
- String
出力を編成するために使用するカテゴリ名。
- 属性
例
次の例では、 という名前の を TraceSwitch 作成します generalSwitch
。 このスイッチは、コード サンプルの外部で設定されます。
スイッチが に TraceLevelVerbose
設定されている場合、この例では、 と の myObject
名前を category
に出力します Listeners。 コレクションにリスナーを追加する Listeners 方法については、 クラスを TraceListenerCollection 参照してください。
次に TraceLevel 、 が 以上に Error
設定されている場合、2 番目のエラー メッセージを最初のメッセージと同じ行に出力します。 2 番目のメッセージの後に行終端記号が続きます。
// Class-level declaration.
// Create a TraceSwitch.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod( Object^ myObject, String^ category )
{
#if defined(TRACE)
// Write the message if the TraceSwitch level is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
Trace::Write( myObject, category );
}
// Write a second message if the TraceSwitch level is set to
// Error or higher.
if ( generalSwitch->TraceError )
{
Trace::WriteLine( " 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 Verbose.
if(generalSwitch.TraceVerbose)
Trace.Write(myObject, category);
// Write a second message if the TraceSwitch level is set to Error or higher.
if(generalSwitch.TraceError)
Trace.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 Verbose.
If generalSwitch.TraceVerbose Then
Trace.Write(myObject, category)
End If
' Write a second message if the TraceSwitch level is set to Error or higher.
If generalSwitch.TraceError Then
Trace.WriteLine(" Object is not valid for this category.")
End If
End Sub
注釈
既定では、出力は の DefaultTraceListenerインスタンスに書き込まれます。
パラメーターを category
使用して、出力メッセージをグループ化できます。
このメソッドは、 Write トレース リスナーの メソッドを呼び出します。
注意
ASP.NET は、Web ページ用に調整されたトレース機能を提供します。 ASP.NET ページでトレース メッセージを書き込むには、 プロパティを Page.Trace 使用します。
既定では、ASP.NET Web ページに関連付けられているコードでは、 ステートメント Trace.Write("...")
は プロパティの WritePage.Trace メソッドの呼び出しです。 Web ページで クラスを System.Diagnostics.Trace 使用するには、 などの名前空間 System.Diagnostics.Trace.Write("...")
を含める必要があります。
こちらもご覧ください
適用対象
Write(String, String)
- ソース:
- Trace.cs
- ソース:
- Trace.cs
- ソース:
- Trace.cs
カテゴリ名とメッセージを Listeners コレクションのトレース リスナーに書き込みます。
public:
static void Write(System::String ^ message, System::String ^ category);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (string? message, string? category);
[System.Diagnostics.Conditional("TRACE")]
public static void Write (string message, string category);
[<System.Diagnostics.Conditional("TRACE")>]
static member Write : string * string -> unit
Public Shared Sub Write (message As String, category As String)
パラメーター
- message
- String
書き込むメッセージ。
- category
- String
出力を編成するために使用するカテゴリ名。
- 属性
例
次の例では、 という名前の を TraceSwitch 作成します generalSwitch
。 このスイッチは、コード サンプルの外部で設定されます。
スイッチが に TraceLevelVerbose
設定されている場合、最初のエラー メッセージが に Listeners出力されます。 コレクションにリスナーを追加する Listeners 方法については、 クラスを TraceListenerCollection 参照してください。
次に TraceLevel 、 が 以上に Error
設定されている場合、2 番目のエラー メッセージを最初のメッセージと同じ行に出力します。 2 番目のメッセージの後に行終端記号が続きます。
// Class-level declaration.
// Create a TraceSwitch.
private:
static TraceSwitch^ generalSwitch =
gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyErrorMethod( Object^ myObject, String^ category )
{
#if defined(TRACE)
// Write the message if the TraceSwitch level is set to Verbose.
if ( generalSwitch->TraceVerbose )
{
Trace::Write( String::Concat( myObject,
" is not a valid object for category: " ), category );
}
// Write a second message if the TraceSwitch level is set to
// Error or higher.
if ( generalSwitch->TraceError )
{
Trace::WriteLine( " Please use a different 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 Verbose.
if(generalSwitch.TraceVerbose)
Trace.Write(myObject.ToString() + " is not a valid object for category: ",
category);
// Write a second message if the TraceSwitch level is set to Error or higher.
if(generalSwitch.TraceError)
Trace.WriteLine(" Please use a different 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 Verbose.
If generalSwitch.TraceVerbose Then
Trace.Write(myObject.ToString() & _
" is not a valid object for category: ", category)
End If
' Write a second message if the TraceSwitch level is set to Error or higher.
If generalSwitch.TraceError Then
Trace.WriteLine(" Please use a different category.")
End If
End Sub
注釈
既定では、出力は の DefaultTraceListenerインスタンスに書き込まれます。
パラメーターを category
使用して、出力メッセージをグループ化できます。
このメソッドは、 Write トレース リスナーの メソッドを呼び出します。
注意
ASP.NET は、Web ページ用に調整されたトレース機能を提供します。 ASP.NET ページでトレース メッセージを書き込むには、 プロパティを Page.Trace 使用します。
既定では、ASP.NET Web ページに関連付けられているコードでは、 ステートメント Trace.Write("...")
は プロパティの WritePage.Trace メソッドの呼び出しです。 Web ページで クラスを System.Diagnostics.Trace 使用するには、 などの名前空間 System.Diagnostics.Trace.Write("...")
を含める必要があります。
こちらもご覧ください
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示