次の方法で共有


Debug.WriteLine メソッド (String, String)

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

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

パラメータ

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

解説

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

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

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

使用例

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

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

TraceLevelVerbose に設定されている場合、この例では、最初のメッセージと同じ行に 2 番目のエラー メッセージと category が表示されます。第 2 のメッセージの後に行終端記号があります。

 
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Debug.Write("My error message. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Debug.WriteLine("My second error message.", category)
    End If
End Sub 'MyErrorMethod 

[C#] 
// Class-level declaration.
 // Create a TraceSwitch.
 static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");
 
 static public void MyErrorMethod(String category) {
    // Write the message if the TraceSwitch level is set to Error or higher.
    if(generalSwitch.TraceError)
       Debug.Write("My error message. ");
 
    // Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch.TraceVerbose)
       Debug.WriteLine("My second error message.", category);
 }


[C++] 
// Class-level declaration.
 // Create a TraceSwitch.
 static TraceSwitch* generalSwitch = new TraceSwitch(S"General", S"Entire Application");
 
public:
 static void MyErrorMethod(String* category) {
    // Write the message if the TraceSwitch level is set to Error or higher.
    if(generalSwitch->TraceError)
       Debug::Write(S"My error message. ");
 
    // Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch->TraceVerbose)
       Debug::WriteLine(S"My second error message.", category);
 }


[JScript] 
// Class level declaration.
 // Create a TraceSwitch.
 static var generalSwitch : TraceSwitch = new TraceSwitch("General", "Entire Application");
 
 static public function MyErrorMethod(category : String) {
    // Write the message if the TraceSwitch level is set to Error or higher.
    if(generalSwitch.TraceError)
       Debug.Write("My error message. ");
 
    //Write a second message if the TraceSwitch level is set to Verbose.
    if(generalSwitch.TraceVerbose)
       Debug.WriteLine("My second error message.", category);
 }

必要条件

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

参照

Debug クラス | Debug メンバ | System.Diagnostics 名前空間 | Debug.WriteLine オーバーロードの一覧 | Debug | Trace | BooleanSwitch | TraceSwitch | TraceListener | DefaultTraceListener | ConditionalAttribute | ConditionalAttribute | ConditionalAttribute | ConditionalAttribute | ConditionalAttribute