ConsoleTraceListenerとは? わかりやすく解説

ConsoleTraceListener クラス

メモ : このクラスは、.NET Framework version 2.0新しく追加されたものです。

トレース出力またはデバッグ出力標準出力または標準エラー ストリーム転送します

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

Public Class ConsoleTraceListener
    Inherits TextWriterTraceListener
Dim instance As ConsoleTraceListener
public class ConsoleTraceListener : TextWriterTraceListener
public ref class ConsoleTraceListener : public
 TextWriterTraceListener
public class ConsoleTraceListener extends TextWriterTraceListener
public class ConsoleTraceListener extends
 TextWriterTraceListener
解説解説
メモメモ

このクラス適用される HostProtectionAttribute 属性Resources プロパティの値は、Synchronization です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的にはアイコンダブルクリックコマンド入力、またはブラウザURL入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラストピックまたは「SQL Server プログラミングホスト保護属性」を参照してください

ConsoleTraceListener クラス使用してトレース メッセージおよびデバッグ メッセージコンソール書き込みますConsoleTraceListener オブジェクト初期化してトレース メッセージを Console.Out ストリーム、または Console.Error ストリーム書き込むことができます

トレース出力およびデバッグ出力有効になっている場合ConsoleTraceListener メッセージは、指定された System.Console ストリーム書き込まれます。これは、メッセージが System.Console.Write メソッドまたは System.Console.WriteLine メソッドによって書き込まれ方法似てます。コンソール アプリケーションでは、System.Console 出力およびエラー ストリームによって既存コンソール ウィンドウメッセージ書き込まれますが、ストリーム転送して System.IO.TextWriter インスタンス書き込むこともできます

Trace、TraceSource、または Debug通じてメッセージコンソール書き込む場合は、ConsoleTraceListener オブジェクト適切な Listeners コレクション追加します。さらに、System.Diagnostics.Trace.Write メソッドまたは System.Diagnostics.Trace.WriteLine メソッド使用することにより、メッセージコンソール直接書き込むこともできます

ほとんどのコンパイラは、条件付きコンパイル フラグ使用してトレース出力およびデバッグ出力有効にます。トレースおよびデバッグ有効にしなかった場合System.Diagnostics.Debug クラスおよび System.Diagnostics.Trace クラス使用して書き込まれメッセージは、事実上無視されます。トレース出力およびデバッグ出力有効にする構文コンパイラ固有です。C# または Visual Basic 以外のコンパイラ使用する場合は、お使いコンピュータマニュアル参照してください

コードConsoleTraceListener オブジェクトListeners コレクション追加したり、アプリケーション構成ファイルConsoleTraceListener オブジェクトListeners コレクション追加したできます特定のコード セクションまたは実行パスのためのメッセージ書き込む場合は、コードConsoleTraceListener オブジェクト追加しますアプリケーション実行中にすべてのトレース メッセージおよびデバッグ メッセージコンソール転送する場合は、アプリケーション構成ファイルConsoleTraceListener オブジェクト追加します

コード特定のセクショントレース メッセージおよびデバッグ メッセージコンソール書き込むには、ConsoleTraceListener オブジェクト初期化して Listeners コレクション追加しますTrace クラスまたは Debug クラス使用してメッセージを含むコードセクションインストルメントます。コード セクション末尾で、ConsoleTraceListener オブジェクトListeners コレクションから削除しClose メソッドConsoleTraceListener呼び出します。

アプリケーション実行中にトレース メッセージおよびデバッグ メッセージコンソール転送するには、ConsoleTraceListener オブジェクトアプリケーション構成ファイル追加しますアプリケーションの名前に対応する構成ファイル、または Visual Studio 2005 プロジェクトの app.config ファイル編集します。このファイルで、ConsoleTraceListener要素挿入します

configConsoleListener という名前の ConsoleTraceListener オブジェクトListeners コレクション追加する例を次に示します

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="configConsoleListener"           type="System.Diagnostics.ConsoleTraceListener"
 />
      </listeners>
    </trace>
  </system.diagnostics>
 </configuration>

アプリケーション構成ファイルでのトレース リスナ追加詳細については、「<trace> の <listeners> 要素」を参照してください

使用例使用例

2 つパブリック メソッドを含むクラス構成されコンソール アプリケーション実装するコード例次に示します

Main メソッドは、コマンド ライン引数調べてトレース出力標準エラー ストリームまたは標準出力ストリーム転送するかどうか決定しますMain は、指定されConsole 出力ストリームConsoleTraceListener オブジェクト作成および初期化し、このオブジェクトトレース リスナ コレクション追加します次にWriteEnvironmentInfoToTrace メソッド呼び出し実行環境およびトレース リスナ構成詳細トレース出力書き込みます

サンプル アプリケーション実行すると、環境およびトレース構成詳細は、ConsoleTraceListener オブジェクト使用して指定されコンソール出力ストリーム書き込まれます。

' Define the TRACE constant, which enables trace output to the 
' Trace.Listeners collection. Typically, this constant is defined
' as a compilation argument.
#Const TRACE = True

Imports System
Imports System.Diagnostics

Public Class ConsoleTraceSample

    ' Define a simple method to write details about the current executing
 
    ' environment to the trace listener collection.
    Public Shared Sub WriteEnvironmentInfoToTrace()

        Dim methodName As String
 = "WriteEnvironmentInfoToTrace"

        Trace.Indent()
        Trace.WriteLine(DateTime.Now.ToString() & " - Start
 of " & methodName)
        Trace.Indent()

        ' Write details on the executing environment to the trace output.
        Trace.WriteLine("Operating system: " &
 _
            System.Environment.OSVersion.ToString())
        Trace.WriteLine("Computer name: " & System.Environment.MachineName)
        Trace.WriteLine("User name: " & System.Environment.UserName)
        Trace.WriteLine("CLR version: " & System.Environment.Version.ToString)
        Trace.WriteLine("Command line: " & System.Environment.CommandLine)

        ' Enumerate the trace listener collection and 
        ' display details about each configured trace listener.
        Trace.WriteLine("Number of configured trace listeners
 = " & _
            Trace.Listeners.Count.ToString())

        Dim tl As TraceListener
        For Each tl In Trace.Listeners
            Trace.WriteLine("Trace listener name = "
 & tl.Name)
            Trace.WriteLine("               type = "
 & tl.GetType().ToString())
        Next tl

        Trace.Unindent()
        Trace.WriteLine(DateTime.Now.ToString() & " - End
 of " & methodName)
        Trace.Unindent()

    End Sub

    ' Define the main entry point of this class.
    ' The main method adds a console trace listener to the collection
    ' of configured trace listeners, then writes details on the current
    ' executing environment.
    Public Shared Sub Main(ByVal
 CmdArgs() As String)

        ' Write a trace message to all configured trace listeners.
        Trace.WriteLine(DateTime.Now.ToString() & " - Start
 of Main")

        ' Define a trace listener to direct trace output from this method
        ' to the console.
        Dim consoleTracer As ConsoleTraceListener

        ' Check the command line arguments to determine which
        ' console stream should be used for trace output.
        If (CmdArgs.Length > 0) AndAlso
 _
           (CmdArgs(0).ToLower.Equals("/stderr"))
 Then
            ' Initialize the console trace listener to write
            ' trace output to the standard error stream.
            consoleTracer = New ConsoleTraceListener(True)
        Else
            ' Initialize the console trace listener to write
            ' trace output to the standard output stream.
            consoleTracer = New ConsoleTraceListener
        End If
        ' Set the name of the trace listener, which helps identify this
 
        ' particular instance within the trace listener collection.
        consoleTracer.Name = "mainConsoleTracer"

        ' Write the initial trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString() & "
 [" & _
             consoleTracer.Name & "] - Starting output to
 trace listener.")

        ' Add the new console trace listener to 
        ' the collection of trace listeners.
        Trace.Listeners.Add(consoleTracer)

        ' Call a local method, which writes information about the current
 
        ' execution environment to the configured trace listeners.
        WriteEnvironmentInfoToTrace()

        ' Write the final trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString() & "
 [" & _
            consoleTracer.Name & "] - Ending output to trace
 listener.")

        ' Flush any pending trace messages, remove the 
        ' console trace listener from the collection,
        ' and close the console trace listener.
        Trace.Flush()
        Trace.Listeners.Remove(consoleTracer)
        consoleTracer.Close()

        ' Write a final trace message to all trace listeners.
        Trace.WriteLine(DateTime.Now.ToString() + " - End of Main")

        ' Close all other configured trace listeners.
        Trace.Close()

    End Sub

End Class
継承階層継承階層
System.Object
   System.MarshalByRefObject
     System.Diagnostics.TraceListener
       System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.ConsoleTraceListener
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
ConsoleTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
TextWriterTraceListener
Debug
Trace
System.Console

ConsoleTraceListener コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0新しく追加されたものです。

標準出力ストリームへのトレース出力指定して、ConsoleTraceListener クラス新しインスタンス初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

Dim instance As New ConsoleTraceListener
public ConsoleTraceListener ()
public:
ConsoleTraceListener ()
public ConsoleTraceListener ()
public function ConsoleTraceListener ()
解説解説
使用例使用例

指定されConsole 出力ストリームConsoleTraceListener オブジェクト初期化してトレース リスナ コレクション追加するコード例次に示します。このコード例は、ConsoleTraceListener クラストピック取り上げているコード例一部分です。

' Define a trace listener to direct trace output from this method
' to the console.
Dim consoleTracer As ConsoleTraceListener

' Check the command line arguments to determine which
' console stream should be used for trace output.
If (CmdArgs.Length > 0) AndAlso _
   (CmdArgs(0).ToLower.Equals("/stderr")) Then
    ' Initialize the console trace listener to write
    ' trace output to the standard error stream.
    consoleTracer = New ConsoleTraceListener(True)
Else
    ' Initialize the console trace listener to write
    ' trace output to the standard output stream.
    consoleTracer = New ConsoleTraceListener
End If
' Set the name of the trace listener, which helps identify this 
' particular instance within the trace listener collection.
consoleTracer.Name = "mainConsoleTracer"

' Write the initial trace message to the console trace listener.
consoleTracer.WriteLine(DateTime.Now.ToString() & " ["
 & _
     consoleTracer.Name & "] - Starting output to trace listener.")

' Add the new console trace listener to 
' the collection of trace listeners.
Trace.Listeners.Add(consoleTracer)
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
ConsoleTraceListener クラス
ConsoleTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener
EventLogTraceListener
TextWriterTraceListener
Console.Out
Debug
Trace

ConsoleTraceListener コンストラクタ (Boolean)

メモ : このコンストラクタは、.NET Framework version 2.0新しく追加されたものです。

トレース出力標準出力ストリームまたは標準エラー ストリーム書き込むためのオプション指定して、ConsoleTraceListener クラス新しインスタンス初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文構文

Public Sub New ( _
    useErrorStream As Boolean _
)
Dim useErrorStream As Boolean

Dim instance As New ConsoleTraceListener(useErrorStream)
public ConsoleTraceListener (
    bool useErrorStream
)
public:
ConsoleTraceListener (
    bool useErrorStream
)
public ConsoleTraceListener (
    boolean useErrorStream
)
public function ConsoleTraceListener (
    useErrorStream : boolean
)

パラメータ

useErrorStream

トレース出力およびデバッグ出力標準エラー ストリーム書き込む場合true標準出力ストリーム書き込む場合false

解説解説

このコンストラクタは、ConsoleTraceListener オブジェクト初期化してメッセージを Console.Out または Console.Error ストリーム書き込みますName プロパティは、空の文字列 ("") に初期化されます

使用例使用例

指定されConsole 出力ストリームConsoleTraceListener オブジェクト初期化してトレース リスナ コレクション追加するコード例次に示します。このコード例は、ConsoleTraceListener クラストピック取り上げているコード例一部分です。

' Define a trace listener to direct trace output from this method
' to the console.
Dim consoleTracer As ConsoleTraceListener

' Check the command line arguments to determine which
' console stream should be used for trace output.
If (CmdArgs.Length > 0) AndAlso _
   (CmdArgs(0).ToLower.Equals("/stderr")) Then
    ' Initialize the console trace listener to write
    ' trace output to the standard error stream.
    consoleTracer = New ConsoleTraceListener(True)
Else
    ' Initialize the console trace listener to write
    ' trace output to the standard output stream.
    consoleTracer = New ConsoleTraceListener
End If
' Set the name of the trace listener, which helps identify this 
' particular instance within the trace listener collection.
consoleTracer.Name = "mainConsoleTracer"

' Write the initial trace message to the console trace listener.
consoleTracer.WriteLine(DateTime.Now.ToString() & " ["
 & _
     consoleTracer.Name & "] - Starting output to trace listener.")

' Add the new console trace listener to 
' the collection of trace listeners.
Trace.Listeners.Add(consoleTracer)
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
ConsoleTraceListener クラス
ConsoleTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener
EventLogTraceListener
TextWriterTraceListener
System.Console
Debug
Trace

ConsoleTraceListener コンストラクタ

ConsoleTraceListener クラス新しインスタンス初期化します。
オーバーロードの一覧オーバーロードの一覧

参照参照

関連項目

ConsoleTraceListener クラス
ConsoleTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener
EventLogTraceListener
TextWriterTraceListener
Console.Out
Debug
Trace

ConsoleTraceListener プロパティ


パブリック プロパティパブリック プロパティ

( プロテクト プロパティ参照)
  名前 説明
パブリック プロパティ Attributes  アプリケーション構成ファイル定義されているカスタム トレース リスナ属性取得します。 ( TraceListener から継承されます。)
パブリック プロパティ Filter  トレース リスナトレース フィルタ取得および設定します。 ( TraceListener から継承されます。)
パブリック プロパティ IndentLevel  インデントレベル取得または設定します。 ( TraceListener から継承されます。)
パブリック プロパティ IndentSize  1 つインデント含まれる空白の数を取得または設定します。 ( TraceListener から継承されます。)
パブリック プロパティ IsThreadSafe  トレース リスナスレッド セーフかどうかを示す値を取得します。 ( TraceListener から継承されます。)
パブリック プロパティ Name  この TraceListener の名前を取得または設定します。 ( TraceListener から継承されます。)
パブリック プロパティ TraceOutputOptions  トレース出力オプション取得または設定します。 ( TraceListener から継承されます。)
パブリック プロパティ Writer  トレース出力またはデバッグ出力受信するテキスト ライタ取得または設定します。 ( TextWriterTraceListener から継承されます。)
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ NeedIndent  出力インデント設定するかどうかを示す値を取得または設定します。 ( TraceListener から継承されます。)
参照参照

関連項目

ConsoleTraceListener クラス
System.Diagnostics 名前空間
TraceListener
TextWriterTraceListener
Debug
Trace
System.Console

ConsoleTraceListener メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド参照)
  名前 説明
パブリック メソッド Close  Writer終了してトレース出力またはデバッグ出力受信しないようにします。 ( TextWriterTraceListener から継承されます。)
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信使用するプロキシ生成必要な情報をすべて格納しているオブジェクト作成します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Dispose  オーバーロードされます。 この TextWriterTraceListener オブジェクト破棄します。 ( TextWriterTraceListener から継承されます。)
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 ( Object から継承されます。)
パブリック メソッド Fail  オーバーロードされます。 TraceListener クラス実装時に作成したリスナエラー メッセージ出力します。 ( TraceListener から継承されます。)
パブリック メソッド Flush  Writer 用の出力バッファフラッシュます。 ( TextWriterTraceListener から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 ( Object から継承されます。)
パブリック メソッド GetLifetimeService  対象インスタンス有効期間ポリシー制御する現在の有効期間サービス オブジェクト取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスType取得します。 ( Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象インスタンス有効期間ポリシー制御する有効期間サービス オブジェクト取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String返します。 ( Object から継承されます。)
パブリック メソッド TraceData  オーバーロードされますトレース データリスナ固有の出力書き込みます。 ( TraceListener から継承されます。)
パブリック メソッド TraceEvent  オーバーロードされますトレース情報およびイベント情報リスナ固有の出力書き込みます。 ( TraceListener から継承されます。)
パブリック メソッド TraceTransfer  トレース情報メッセージ関連するアクティビティ ID、およびイベント情報リスナ固有の出力書き込みます。 ( TraceListener から継承されます。)
パブリック メソッド Write  オーバーロードされます。 このインスタンスWriterメッセージ書き込みます。 ( TextWriterTraceListener から継承されます。)
パブリック メソッド WriteLine  オーバーロードされます。 このインスタンスWriterメッセージ書き込み続けて終端記号書き込みます。 ( TextWriterTraceListener から継承されます。)
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

ConsoleTraceListener クラス
System.Diagnostics 名前空間
TraceListener
TextWriterTraceListener
Debug
Trace
System.Console

ConsoleTraceListener メンバ

トレース出力またはデバッグ出力標準出力または標準エラー ストリーム転送します

ConsoleTraceListener データ型公開されるメンバを以下の表に示します


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド ConsoleTraceListener オーバーロードされます。 ConsoleTraceListener クラス新しインスタンス初期化します。
パブリック プロパティパブリック プロパティ
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ NeedIndent  出力インデント設定するかどうかを示す値を取得または設定します。(TraceListener から継承されます。)
パブリック メソッドパブリック メソッド
( プロテクト メソッド参照)
  名前 説明
パブリック メソッド Close  Writer終了してトレース出力またはデバッグ出力受信しないようにします。 (TextWriterTraceListener から継承されます。)
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信使用するプロキシ生成必要な情報をすべて格納しているオブジェクト作成します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Dispose  オーバーロードされます。 この TextWriterTraceListener オブジェクト破棄します。 (TextWriterTraceListener から継承されます。)
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 (Object から継承されます。)
パブリック メソッド Fail  オーバーロードされます。 TraceListener クラス実装時に作成したリスナエラー メッセージ出力します。 (TraceListener から継承されます。)
パブリック メソッド Flush  Writer 用の出力バッファフラッシュます。 (TextWriterTraceListener から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 (Object から継承されます。)
パブリック メソッド GetLifetimeService  対象インスタンス有効期間ポリシー制御する現在の有効期間サービス オブジェクト取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスType取得します。 (Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象インスタンス有効期間ポリシー制御する有効期間サービス オブジェクト取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String返します。 (Object から継承されます。)
パブリック メソッド TraceData  オーバーロードされますトレース データリスナ固有の出力書き込みます。 (TraceListener から継承されます。)
パブリック メソッド TraceEvent  オーバーロードされますトレース情報およびイベント情報リスナ固有の出力書き込みます。 (TraceListener から継承されます。)
パブリック メソッド TraceTransfer  トレース情報メッセージ関連するアクティビティ ID、およびイベント情報リスナ固有の出力書き込みます。 (TraceListener から継承されます。)
パブリック メソッド Write  オーバーロードされます。 このインスタンスWriterメッセージ書き込みます。 (TextWriterTraceListener から継承されます。)
パブリック メソッド WriteLine  オーバーロードされます。 このインスタンスWriterメッセージ書き込み続けて終端記号書き込みます。 (TextWriterTraceListener から継承されます。)
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

ConsoleTraceListener クラス
System.Diagnostics 名前空間
TraceListener
TextWriterTraceListener
Debug
Trace
System.Console


このページでは「.NET Framework クラス ライブラリ リファレンス」からConsoleTraceListenerを検索した結果を表示しています。
Weblioに収録されているすべての辞書からConsoleTraceListenerを検索する場合は、下記のリンクをクリックしてください。
 全ての辞書からConsoleTraceListener を検索

英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「ConsoleTraceListener」の関連用語

ConsoleTraceListenerのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



ConsoleTraceListenerのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2024 Microsoft.All rights reserved.

©2024 GRAS Group, Inc.RSS