Debug.WriteLine メソッド (Object, String)
カテゴリ名およびオブジェクトの ToString メソッドの値を、 Listeners コレクションのトレース リスナに書き込みます。
<Conditional("DEBUG")>
Overloads Public Shared Sub WriteLine( _ ByVal value As Object, _ ByVal category As String _)
[C#]
[Conditional("DEBUG")]
public static void WriteLine(objectvalue,stringcategory);
[C++]
[Conditional("DEBUG")]
public: static void WriteLine(Object* value,String* category);
[JScript]
public
Conditional("DEBUG")
static function WriteLine(value : Object,category : String);
パラメータ
- value
名前が Listeners に送信されるオブジェクト。 - 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
Debug.Write("Invalid object for category. ")
End If
' Write a second message if the TraceSwitch level is set to Verbose.
If generalSwitch.TraceVerbose Then
Debug.WriteLine(myObject, 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(Object myObject, String category) {
// Write the message if the TraceSwitch level is set to Error or higher.
if(generalSwitch.TraceError)
Debug.Write("Invalid object for category. ");
// Write a second message if the TraceSwitch level is set to Verbose.
if(generalSwitch.TraceVerbose)
Debug.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)
Debug::Write(S"Invalid object for category. ");
// Write a second message if the TraceSwitch level is set to Verbose.
if(generalSwitch->TraceVerbose)
Debug::WriteLine(myObject, category);
}
[JScript]
// Class level declaration.
// Create a TraceSwitch.
static var generalSwitch : TraceSwitch = new TraceSwitch("General", "Entire Application");
static public function MyErrorMethod(myObject : Object, category : String) {
// Write the message if the TraceSwitch level is set to Error or higher.
if(generalSwitch.TraceError)
Debug.Write("Invalid object for category. ");
//Write a second message if the TraceSwitch level is set to Verbose.
if(generalSwitch.TraceVerbose)
Debug.WriteLine(myObject, 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