XmlWriterTraceListener

.NET Framework クラス ライブラリ リファレンス

XmlWriterTraceListener クラス

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

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

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

Visual Basic (宣言)

Public Class XmlWriterTraceListener
    Inherits TextWriterTraceListener

Visual Basic (使用法)

Dim instance As XmlWriterTraceListener

C#

public class XmlWriterTraceListener : TextWriterTraceListener

C++

public ref class XmlWriterTraceListener : public
 TextWriterTraceListener

J#

public class XmlWriterTraceListener extends
 TextWriterTraceListener

JScript

public class XmlWriterTraceListener extends
 TextWriterTraceListener

解説

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

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

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 が自動的に付けられます。

メモ
リスナ メソッドは、Debug、Trace、および 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 メソッドが呼び出され、ルート ノード全体がエスケープされていないデータとしてトレースされます。

エスケープ文字	値
&	&
<	&lt;
>	&gt;
"	&quot;
\	&apos;
0xD	&#xD;
0xA	&#xA;

使用例

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

Visual Basic

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

C#

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 のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

継承階層

System.Object
   System.MarshalByRefObject
     System.Diagnostics.TraceListener
       System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.XmlWriterTraceListener

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

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

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    filename As String, _
    name As String _
)

Visual Basic (使用法)

Dim filename As String
Dim name As String

Dim instance As New XmlWriterTraceListener(filename,
 name)

C#

public XmlWriterTraceListener (
    string filename,
    string name
)

C++

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

J#

public XmlWriterTraceListener (
    String filename, 
    String name
)

JScript

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

パラメータ

filename

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

name

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

例外

例外の種類	条件
ArgumentNullException	stream が null 参照 (Visual Basic では Nothing) です。

解説

このコンストラクタは、UTF8 エンコーディングを使用して、指定されたパスの指定されたファイルに対する StreamWriter クラスの新しいインスタンスを初期化します。ファイルが存在する場合は、ファイルに追加されます。ファイルが存在しない場合は、新しいファイルが作成されます。

メモ
例外が発生する可能性を減らすために、出力を無効にする可能性のある文字を "?" 文字で置き換えます。

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

((XmlWriterTraceListener)Trace.Listeners["xmlListener"]).TraceOutputOptions =
    TraceOptions.Timestamp.

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ (TextWriter)

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    writer As TextWriter _
)

Visual Basic (使用法)

Dim writer As TextWriter

Dim instance As New XmlWriterTraceListener(writer)

C#

public XmlWriterTraceListener (
    TextWriter writer
)

C++

public:
XmlWriterTraceListener (
    TextWriter^ writer
)

J#

public XmlWriterTraceListener (
    TextWriter writer
)

JScript

public function XmlWriterTraceListener (
    writer : TextWriter
)

パラメータ

writer

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

例外

例外の種類	条件
ArgumentNullException	writer が null 参照 (Visual Basic では Nothing) です。

解説

Name プロパティは空の文字列 ("") に初期化されます。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ (String)

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    filename As String _
)

Visual Basic (使用法)

Dim filename As String

Dim instance As New XmlWriterTraceListener(filename)

C#

public XmlWriterTraceListener (
    string filename
)

C++

public:
XmlWriterTraceListener (
    String^ filename
)

J#

public XmlWriterTraceListener (
    String filename
)

JScript

public function XmlWriterTraceListener (
    filename : String
)

パラメータ

filename

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

例外

例外の種類	条件
ArgumentNullException	filename が null 参照 (Visual Basic では Nothing) です。

解説

このコンストラクタは、UTF8 エンコーディングを使用して、指定されたパスの指定されたファイルに対する StreamWriter クラスの新しいインスタンスを初期化します。ファイルが存在する場合は、ファイルに追加されます。ファイルが存在しない場合は、新しいファイルが作成されます。

メモ
例外が発生する可能性を減らすために、出力を無効にする可能性のある文字を "?" 文字で置き換えます。

Name プロパティは空の文字列 ("") に初期化されます。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

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

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    stream As Stream, _
    name As String _
)

Visual Basic (使用法)

Dim stream As Stream
Dim name As String

Dim instance As New XmlWriterTraceListener(stream,
 name)

C#

public XmlWriterTraceListener (
    Stream stream,
    string name
)

C++

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

J#

public XmlWriterTraceListener (
    Stream stream, 
    String name
)

JScript

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

パラメータ

stream

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

name

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

例外

例外の種類	条件
ArgumentNullException	stream が null 参照 (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 のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ

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

名前	説明
XmlWriterTraceListener (Stream)	指定されたストリームをデバッグ出力およびトレース出力の受信者として使用して、XmlWriterTraceListener クラスの新しいインスタンスを初期化します。
XmlWriterTraceListener (String)	指定されたファイルをデバッグ出力およびトレース出力の受信者として使用して、XmlWriterTraceListener クラスの新しいインスタンスを初期化します。
XmlWriterTraceListener (TextWriter)	指定されたライタをデバッグ出力およびトレース出力の受信者として使用して、XmlWriterTraceListener クラスの新しいインスタンスを初期化します。
XmlWriterTraceListener (Stream, String)	指定されたストリームをデバッグ出力およびトレース出力の受信者として使用して、XmlWriterTraceListener クラスの新しいインスタンスを初期化します。
XmlWriterTraceListener (String, String)	指定されたファイルをデバッグ出力およびトレース出力の受信者として使用して、XmlWriterTraceListener クラスの新しいインスタンスを初期化します。
XmlWriterTraceListener (TextWriter, String)	指定されたライタをデバッグ出力およびトレース出力の受信者として使用して、XmlWriterTraceListener クラスの新しいインスタンスを初期化します。

参照

関連項目

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

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

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    writer As TextWriter, _
    name As String _
)

Visual Basic (使用法)

Dim writer As TextWriter
Dim name As String

Dim instance As New XmlWriterTraceListener(writer,
 name)

C#

public XmlWriterTraceListener (
    TextWriter writer,
    string name
)

C++

public:
XmlWriterTraceListener (
    TextWriter^ writer, 
    String^ name
)

J#

public XmlWriterTraceListener (
    TextWriter writer, 
    String name
)

JScript

public function XmlWriterTraceListener (
    writer : TextWriter, 
    name : String
)

パラメータ

writer

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

name

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

例外

例外の種類	条件
ArgumentNullException	writer が null 参照 (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 のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlWriterTraceListener クラス
XmlWriterTraceListener メンバ
System.Diagnostics 名前空間

XmlWriterTraceListener コンストラクタ (Stream)

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    stream As Stream _
)

Visual Basic (使用法)

Dim stream As Stream

Dim instance As New XmlWriterTraceListener(stream)

C#

public XmlWriterTraceListener (
    Stream stream
)

C++

public:
XmlWriterTraceListener (
    Stream^ stream
)

J#

public XmlWriterTraceListener (
    Stream stream
)

JScript

public function XmlWriterTraceListener (
    stream : Stream
)

パラメータ

stream

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

例外

例外の種類	条件
ArgumentNullException	stream が null 参照 (Visual Basic では Nothing) です。

解説

Name プロパティは空の文字列 ("") に初期化されます。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
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	オーバーロードされます。 指定された情報をファイルまたはストリームに書き込み、続けて行終端記号を書き込みます。

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 この TextWriterTraceListener オブジェクトを破棄します。 ( TextWriterTraceListener から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetSupportedAttributes	トレース リスナによってサポートされるカスタム属性を取得します。 ( TraceListener から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	WriteIndent	このクラスの実装時に作成したリスナにインデントを書き込み、NeedIndent プロパティを false にリセットします。 ( TraceListener から継承されます。)

参照

関連項目

XmlWriterTraceListener クラス
System.Diagnostics 名前空間

XmlWriterTraceListener メンバ

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

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

パブリック コンストラクタ

	名前	説明
	XmlWriterTraceListener	オーバーロードされます。 XmlWriterTraceListener クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

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

プロテクト プロパティ

	名前	説明
	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	オーバーロードされます。 指定された情報をファイルまたはストリームに書き込み、続けて行終端記号を書き込みます。

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 この TextWriterTraceListener オブジェクトを破棄します。 (TextWriterTraceListener から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetSupportedAttributes	トレース リスナによってサポートされるカスタム属性を取得します。 (TraceListener から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	WriteIndent	このクラスの実装時に作成したリスナにインデントを書き込み、NeedIndent プロパティを false にリセットします。 (TraceListener から継承されます。)

参照

関連項目

XmlWriterTraceListener クラス
System.Diagnostics 名前空間