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

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

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

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

パラメータ

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

解説

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

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

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

使用例

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

スイッチが TraceLevel Verbose に設定されている場合、この例では、 myObject の名前と category を Listeners に出力します。 Listeners コレクションにリスナを追加する方法については、 TraceListenerCollection クラスのトピックを参照してください。

TraceLevel が Error 以上に設定されている場合、この例では、最初のメッセージと同じ行に 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 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


[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 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.");
 }


[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 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(S" Object is not valid for this 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.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.")
}

必要条件

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

参照

次の方法で共有

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

パラメータ

解説

使用例

必要条件

参照

その他のリソース