Trace.WriteLine メソッド (Object, String)

[アーティクル]
03/28/2008

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

<Conditional("TRACE")>
Overloads Public Shared Sub WriteLine( _   ByVal value As Object, _   ByVal category As String _)
[C#]
[Conditional("TRACE")]
public static void WriteLine(objectvalue,stringcategory);
[C++]
[Conditional("TRACE")]
public: static void WriteLine(Object* value,String* category);
[JScript]
public
   Conditional("TRACE")
static function WriteLine(value : Object,category : String);

パラメータ

value
名前が Listeners に送信される Object 。
category
出力を編成するために使用されるカテゴリ名。

解説

既定では、出力は DefaultTraceListener のインスタンスに書き込まれます。

Category パラメータは、出力メッセージをグループ化するために使用できます。

このメソッドは、トレースリスナの WriteLine メソッドを呼び出します。

使用例

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

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

TraceLevel が Verbose に設定されている場合、この例では、最初のメッセージと同じ行に 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 Error or higher.
    If generalSwitch.TraceError Then
        Trace.Write("Invalid object for category. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Trace.WriteLine(myObject, category)
    End If
End Sub


[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 Error or higher.
    if(generalSwitch.TraceError)
       Trace.Write("Invalid object for category. ");
 
    // Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch.TraceVerbose)
       Trace.WriteLine(myObject, 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 Error or higher.
    if(generalSwitch->TraceError)
       Trace::Write(S"Invalid object for category. ");
 
    // Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch->TraceVerbose)
       Trace::WriteLine(myObject, category);
 }


[JScript] 
// Create a TraceSwitch.
var generalSwitch : TraceSwitch = new TraceSwitch("General", "Entire Application")

function MyErrorMethod(myObject : Object, category : String){
  // Write the message if the TraceSwitch level is set to Verbose.
  if(generalSwitch.TraceVerbose)
    Trace.WriteLine(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.")
}

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

次の方法で共有

Trace.WriteLine メソッド (Object, String)

パラメータ

解説

使用例

必要条件

参照

その他のリソース