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

XmlWriterTraceListener クラス

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

トレース出力またはデバッグ出力XML エンコードされたデータとして TextWriter または Stream (FileStream など) に転送します

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

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

XmlWriterTraceListener クラスインスタンス作成するには、アンマネージ コード アクセス許可持っている必要があります

XmlWriterTraceListener クラスは、トレース情報およびデバッグ情報XML エンコードされたテキスト ストリーム変換しますXML 出力説明次の表に示します

アプリケーション構成ファイルXmlWriterTraceListener を有効または無効にし、構成した XmlWriterTraceListenerアプリケーション使用できますまた、XmlWriterTraceListenerコード作成できます

XmlWriterTraceListener構成するには、アプリケーションの名前に対応する構成ファイル編集します。このファイルで、リスナ追加または削除リスナプロパティ設定、またはリスナ削除を行うことができます構成ファイル書式次の例のとおりです。

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="xmlListener" 
          type="System.Diagnostics.XmlWriterTraceListener" 
          initializeData="xmlOutput.xml" 
          traceOutputOptions="ProcessId, DateTime" />
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

XmlWriterTraceListener クラスは、Filter プロパティ基本クラス TraceListener から継承しますFilter プロパティにより、リスナにおけるトレース出力フィルタ処理レベル追加できますフィルタ存在する場合トレース リスナTrace メソッドフィルタの ShouldTrace メソッド呼び出してトレース出力するかどうか決定します

メモメモ

使用中ファイルまたは使用できないファイルへの書き込み試みた場合ファイル名プレフィックスとして GUID自動的に付けられます。

メモメモ

リスナ メソッドは、DebugTrace、および TraceSource の各クラスメソッド呼び出すためのものです。リスナ メソッドは、アプリケーション コードから直接呼び出すためのものではありません。XmlWriterTraceListener リスナは、主に TraceSource クラス使用しますWrite メソッドおよび WriteLine メソッドは、Trace クラスおよび Debug クラスによって呼び出すことができますTrace および Debug が値を提供しない XML 要素に対して既定値提供されています。

XML 出力要素および属性説明次の表に示します

要素

属性

出力

説明

CallStack

なし

TraceOutputOptions プロパティ内の Callstack フラグ存在依存します

> や < などの特殊文字は、エスケープ シーケンス置き換えられます。この表の次に示すエスケープ文字変換表参照してください

Computer

なし

常に存在します

MachineName プロパティの値。

Correlation

ActivityID

常に存在します

指定しない場合既定値は空の GUID です。

RelatedActivityID

Trace メソッド呼び出し内の relatedActivityId パラメータ存在依存します

TraceTransfer メソッドrelatedActivityId パラメータ

DataItem

なし

TraceData メソッドdata パラメータ依存します

この要素には、要素配列または 1 つ要素含まれているので、値は DataItem ノードセットとして TraceData 要素の下に書き込まれます。

データ出力は、渡されデータ オブジェクトToString メソッド使用します

EventID

なし

常に存在します

パラメータ入力 (id)。

Execution

ProcessName

常に存在します

TraceEventCache から。

ProcessID

常に存在します

TraceEventCache から。Windows 98 および Windows Me オペレーティング システムでは、ProcessID が 2,147,483,647 より大きい場合負数の正の表現であり、適切なプロセス識別子取得できるように変換する必要があります

ThreadID

常に存在します

TraceEventCache から。

Level

なし

常に存在します

パラメータ入力 (eventType数値)。255 よりも大きパラメータ値は、255 として出力されます。

LogicalOperationStack

なし

TraceOutputOptions プロパティ内の LogicalOperationStack フラグ存在依存します

複数論理演算存在する可能性があるので、値は LogicalOperation ノードとして LogicalOperationStack 要素の下に書き込まれます。

Message

なし

Trace メソッド呼び出し内のメッセージ存在依存します

この要素は、書式指定引数提供されている場合書式設定されたメッセージです。

Source

Name

常に存在します

パラメータ入力

SubType

Name

常に存在します

パラメータ入力

TimeCreated

SystemTime

常に存在します

TraceEventCache存在しない場合既定現在の時刻です。

TimeStamp

なし

TraceOutputOptions プロパティ内の Timestamp フラグ存在依存します

TraceEventCache から。

Type

なし

常に存在します

常に、値 3 です。

XML 出力エスケープされる文字次の表に示しますエスケープはほぼすべての要素と属性実行されますが、例外ありますTraceData メソッドdata パラメータ渡されオブジェクトが XPathNavigator オブジェクト場合DataItem 要素エスケープされません。データ オブジェクトXPathNavigator使用される場合、MoveToRoot メソッド呼び出されルート ノード全体エスケープされていないデータとしてトレースされます

エスケープ文字

&

&amp;

<

&lt;

>

&gt;

"

&quot;

\

&apos;

0xD

&#xD;

0xA

&#xA;

使用例使用例

XmlWriterTraceListener クラス使用してエスケープされるデータエスケープされないデータ両方ファイル ログ書き込むコード例次に示します

Imports System
Imports System.IO
Imports System.Xml
Imports System.Xml.XPath
Imports System.Diagnostics



Class testClass
    
    Shared Sub Main() 
        File.Delete("NotEscaped.xml")
        Dim ts As New TraceSource("TestSource")
        ts.Listeners.Add(New XmlWriterTraceListener("NotEscaped.xml"))
        ts.Switch.Level = SourceLevels.All
        Dim testString As String
 = "<Test><InnerElement Val=""1""
 /><InnerElement Val=""Data""/><AnotherElement>11</AnotherElement></Test>"
        Dim myXml As New
 XmlTextReader(New StringReader(testString))
        Dim xDoc As New
 XPathDocument(myXml)
        Dim myNav As XPathNavigator = xDoc.CreateNavigator()
        ts.TraceData(TraceEventType.Error, 38, myNav)

        ts.Flush()
        ts.Close()
        
        File.Delete("Escaped.xml")
        Dim ts2 As New TraceSource("TestSource2")
        ts2.Listeners.Add(New XmlWriterTraceListener("Escaped.xml"))
        ts2.Switch.Level = SourceLevels.All
        ts2.TraceData(TraceEventType.Error, 38, testString)
        
        ts2.Flush()
        ts2.Close()
    
    End Sub 'Main
End Class 'testClass
using System;
using System.IO;
using System.Xml;
using System.Xml.XPath;
using System.Diagnostics;

class testClass
{
    static void Main()
    {
        File.Delete("NotEscaped.xml");
        TraceSource ts = new TraceSource("TestSource");
        ts.Listeners.Add(new XmlWriterTraceListener("NotEscaped.xml"));
        ts.Switch.Level = SourceLevels.All;
        string testString = "<Test><InnerElement
 Val=\"1\" /><InnerElement Val=\"Data\"/><AnotherElement>11</AnotherElement></Test>";
        XmlTextReader myXml = new XmlTextReader(new
 StringReader(testString));
        XPathDocument xDoc = new XPathDocument(myXml);
        XPathNavigator myNav = xDoc.CreateNavigator();
        ts.TraceData(TraceEventType.Error, 38, myNav);

        ts.Flush();
        ts.Close();

        File.Delete("Escaped.xml");
        TraceSource ts2 = new TraceSource("TestSource2");
        ts2.Listeners.Add(new XmlWriterTraceListener("Escaped.xml"));
        ts2.Switch.Level = SourceLevels.All;
        ts2.TraceData(TraceEventType.Error, 38, testString);

        ts2.Flush();
        ts2.Close();
    }
}
.NET Framework のセキュリティ.NET Frameworkセキュリティ
継承階層継承階層
System.Object
   System.MarshalByRefObject
     System.Diagnostics.TraceListener
       System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.XmlWriterTraceListener
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlWriterTraceListener コンストラクタ (String, String)

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

指定されファイルデバッグ出力およびトレース出力受信者として使用して、XmlWriterTraceListener クラス新しインスタンス初期化します。

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

public XmlWriterTraceListener (
    string filename,
    string name
)
public:
XmlWriterTraceListener (
    String^ filename, 
    String^ name
)
public XmlWriterTraceListener (
    String filename, 
    String name
)
public function XmlWriterTraceListener (
    filename : String, 
    name : String
)

パラメータ

filename

書き込み先のファイルの名前。

name

新規インスタンスの名前。

例外例外
例外種類条件

ArgumentNullException

streamnull 参照 (Visual Basic では Nothing) です。

解説解説
.NET Framework のセキュリティ.NET Frameworkセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ (TextWriter)

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

指定されライタデバッグ出力およびトレース出力受信者として使用して、XmlWriterTraceListener クラス新しインスタンス初期化します。

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

Dim writer As TextWriter

Dim instance As New XmlWriterTraceListener(writer)
public XmlWriterTraceListener (
    TextWriter writer
)
public:
XmlWriterTraceListener (
    TextWriter^ writer
)
public XmlWriterTraceListener (
    TextWriter writer
)
public function XmlWriterTraceListener (
    writer : TextWriter
)

パラメータ

writer

トレース リスナからの出力受信する TextWriter

例外例外
例外種類条件

ArgumentNullException

writernull 参照 (Visual Basic では Nothing) です。

解説解説
.NET Framework のセキュリティ.NET Frameworkセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ (String)

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

指定されファイルデバッグ出力およびトレース出力受信者として使用して、XmlWriterTraceListener クラス新しインスタンス初期化します。

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

Dim filename As String

Dim instance As New XmlWriterTraceListener(filename)
public XmlWriterTraceListener (
    string filename
)
public:
XmlWriterTraceListener (
    String^ filename
)
public XmlWriterTraceListener (
    String filename
)
public function XmlWriterTraceListener (
    filename : String
)

パラメータ

filename

書き込み先のファイルの名前。

例外例外
例外種類条件

ArgumentNullException

filenamenull 参照 (Visual Basic では Nothing) です。

解説解説
.NET Framework のセキュリティ.NET Frameworkセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ (Stream, String)

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

指定されストリームデバッグ出力およびトレース出力受信者として使用して、XmlWriterTraceListener クラス新しインスタンス初期化します。

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

public XmlWriterTraceListener (
    Stream stream,
    string name
)
public:
XmlWriterTraceListener (
    Stream^ stream, 
    String^ name
)
public XmlWriterTraceListener (
    Stream stream, 
    String name
)
public function XmlWriterTraceListener (
    stream : Stream, 
    name : String
)

パラメータ

stream

トレース リスナ書き込むストリームを表す Stream

name

新規インスタンスの名前。

例外例外
例外種類条件

ArgumentNullException

streamnull 参照 (Visual Basic では Nothing) です。

解説解説

このコンストラクタName プロパティname パラメータ値に初期化します。name パラメータnull 参照 (Visual Basic では Nothing) の場合は、空の文字列 ("") に初期化します。名前を Trace.Listeners コレクションインデックスとして使用してリスナプロパティプログラム変更できます。たとえば、次のコードでは、Name プロパティが "xmlListener" である、XmlWriterTraceListenerインスタンスの TraceOutputOptions プロパティ設定します

((XmlWriterTraceListener)Trace.Listeners["xmlListener"]).TraceOutputOptions = 
    TraceOptions.Timestamp
.NET Framework のセキュリティ.NET Frameworkセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ

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

参照参照

関連項目

XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ (TextWriter, String)

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

指定されライタデバッグ出力およびトレース出力受信者として使用して、XmlWriterTraceListener クラス新しインスタンス初期化します。

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

例外例外
例外種類条件

ArgumentNullException

writernull 参照 (Visual Basic では Nothing) です。

解説解説

このコンストラクタName プロパティname パラメータ値に初期化します。name パラメータnull 参照 (Visual Basic では Nothing) の場合は、空の文字列 ("") に初期化します。名前を Trace.Listeners コレクションインデックスとして使用してリスナプロパティプログラム変更できます。たとえば、次のコードでは、Name プロパティが "xmlListener" である、XmlWriterTraceListenerインスタンスの TraceOutputOptions プロパティ設定します

((XmlWriterTraceListener)Trace.Listeners["xmlListener"]).TraceOutputOptions = 
    TraceOptions.Timestamp.
.NET Framework のセキュリティ.NET Frameworkセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ (Stream)

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

指定されストリームデバッグ出力およびトレース出力受信者として使用して、XmlWriterTraceListener クラス新しインスタンス初期化します。

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

Dim stream As Stream

Dim instance As New XmlWriterTraceListener(stream)
public XmlWriterTraceListener (
    Stream stream
)
public:
XmlWriterTraceListener (
    Stream^ stream
)
public XmlWriterTraceListener (
    Stream stream
)
public function XmlWriterTraceListener (
    stream : Stream
)

パラメータ

stream

トレース リスナ書き込むストリームを表す Stream

例外例外
例外種類条件

ArgumentNullException

streamnull 参照 (Visual Basic では Nothing) です。

解説解説
.NET Framework のセキュリティ.NET Frameworkセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener プロパティ


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

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

関連項目

XmlWriterTraceListener クラス
System.Diagnostics 名前空間

XmlWriterTraceListener メソッド


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

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

関連項目

XmlWriterTraceListener クラス
System.Diagnostics 名前空間

XmlWriterTraceListener メンバ

トレース出力またはデバッグ出力XML エンコードされたデータとして TextWriter または Stream (FileStream など) に転送します

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


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

関連項目

XmlWriterTraceListener クラス
System.Diagnostics 名前空間



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

辞書ショートカット

すべての辞書の索引

「XmlWriterTraceListener」の関連用語

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

   

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



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

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

©2025 GRAS Group, Inc.RSS