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

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

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

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

パラメータ

message
書き込むメッセージ。
category
出力を編成するために使用されるカテゴリ名。

解説

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

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

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

使用例

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

スイッチが TraceLevel Verbose に設定されている場合、この例では、最初のエラーメッセージが 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.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


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


[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(String::Concat( myObject, S" 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(S" Please use a different 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.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.")
}

必要条件

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

参照

次の方法で共有

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

パラメータ

解説

使用例

必要条件

参照

その他のリソース