FileLogTraceListener

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

FileLogTraceListener クラス

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

ログ出力をファイルにリダイレクトするシンプルなリスナを提供します。

名前空間: Microsoft.VisualBasic.Logging
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Class FileLogTraceListener
    Inherits TraceListener

Visual Basic (使用法)

Dim instance As FileLogTraceListener

C#

[ComVisibleAttribute(false)] 
public class FileLogTraceListener : TraceListener

C++

[ComVisibleAttribute(false)] 
public ref class FileLogTraceListener : public
 TraceListener

J#

/** @attribute ComVisibleAttribute(false) */ 
public class FileLogTraceListener extends TraceListener

JScript

ComVisibleAttribute(false) 
public class FileLogTraceListener extends
 TraceListener

解説

FileLogTraceListener クラスは、ログ ファイルを必要に応じて (毎日またはアプリケーション単位など) 自動的にアーカイブするための保守機能を提供します。自動アーカイブ機能を使用することで、開発者および管理者の保守作業の負担を減らすことができます。

FileLogTraceListener のインスタンスを Debug.Listeners コレクションまたは Trace.Listeners コレクションに追加することにより、ログ出力をテキスト ファイルにリダイレクトできます。Visual Basic アプリケーションでは、このクラスのインスタンスを、My.Application.Log または My.Log (Web アプリケーションの場合) に追加することもできます。詳細については、「チュートリアル : My.Application.Log による情報の書き込み先の変更.」を参照してください。

このクラスの主な機能を次に示します。

1. アーカイブ機能。このクラスによって生成されるログ ファイルは、基本名と日付に基づいて命名され、さらに、ログ ファイルのバージョンを識別するための番号が付加されます。新しいログ ファイルは必要に応じて作成されます。

   具体的には、baseName[-dateStamp][-version].log という形式で命名されます。

   • baseName の部分は、BaseFileName プロパティによって指定された基本的なログ名になります。

   • dateStamp の部分は、LogFileCreationSchedule が Daily または Weekly の場合に、"YYYY-MM-DD" 形式で表記されます。

   • 同じ baseName および dateStamp を持つ複数のログ ファイルが必要となった場合は、そのファイル名に加えて、version の部分に正の Integer が入ります。

2. 複数のクラス インスタンスに対応。FileLogTraceListener クラスのインスタンスが出力しようとしているファイルが使用中であった場合、次のような処理が行われます。

   • FileLogTraceListener クラスの他のインスタンスが同じプロセスでファイルを使用していた場合、複数のインスタンスによってファイルが共有されます。

   • ファイルが別のプロセスによって使用されていた場合は、次に利用可能な名前を使って新しいログ ファイルが作成されます。

ログ ファイルの場所

• Location プロパティは、ログ ファイルの一般的な出力先ディレクトリを示す、LogFileLocation 列挙体のいずれかの値を引数として受け取ります。

• ログを他の場所に出力する場合は、CustomLocation プロパティを目的の場所に設定してください。

ログ ファイルの名前

• ログ ファイルの基本名は、BaseFileName プロパティによって指定されます。

• 現在のログ ファイル名を取得するには FullLogFileName プロパティを使用します。このプロパティの値は、いくつかの他のプロパティ、および、ファイル システムにおけるログの状態に基づいて取得されます。

ログの保守

• LogFileCreationSchedule プロパティは、新しいログ ファイルが作成される最小頻度を決定します。この値が Daily または Weekly の場合、少なくとも 1 日に 1 回または 1 週間に 1 回の割合で新しいログ ファイルが作成され、その日付が FullLogFileName に追加されます。

• MaxFileSize プロパティは、ログ ファイルの最大サイズ (バイト) を決定します。ログ ファイルのサイズがこの値を超えた場合は、それ以降、ログに出力されたメッセージは破棄され、DiskSpaceExhaustedBehavior プロパティの値によっては例外がスローされます。

• ReserveDiskSpace プロパティは、確保される空き領域 (バイト) を決定します。これにより、空きディスク領域が FileLogTraceListener クラスによってすべて消費されてしまうのを確実に防ぐことができます。ディスクの空き領域が ReserveDiskSpace で指定されたバイト数を下回った場合のログ出力の動作を指定するには、DiskSpaceExhaustedBehavior プロパティを使用します。

ログ ファイルの出力設定

• AutoFlush プロパティは、ログ ファイル ストリームへの書き込み後、その都度、バッファを自動的にフラッシュするかどうかを指定します。

• Append プロパティは、既存のログ ファイルが存在する場合に、メッセージをそのログ ファイルに追記するか、新しいログ ファイルに出力するかを指定します。

• Delimiter プロパティは、ログ メッセージ内でフィールドの区切り記号として使用する文字列を指定します。

• Encoding プロパティは、新しいログ ファイルを作成する際に使用するエンコーディングを指定します。

ログ ファイル出力

• TraceData メソッドおよび TraceEvent メソッドでは、ログ ファイルにメッセージが出力されます。これらのメソッドは、LogFileCreationSchedule プロパティをチェックすると共に、同じ基本名を持つ既存のログが存在するかどうかを調べ、新しいログを作成する必要があるかどうかを決定します。

• Flush メソッドは、現在出力バッファに格納されているすべてのメッセージをログ ファイルにフラッシュします。

• Close メソッドは、ログ ファイルを閉じて、他のプロセスが使用できる状態にします。

出力の有効化

トレース リスナを使用するには、トレースまたはデバッグを有効にする必要があります。次の構文はコンパイラに固有です。C# または Visual Basic 以外のコンパイラを使用する場合は、使用するコンパイラのドキュメントを参照してください。

• C# でデバッグを有効にするには、コードのコンパイル時に /d:DEBUG フラグをコンパイラのコマンド ラインに追加するか、#define DEBUG をファイルの最上部に挿入します。Visual Basic では、コンパイラのコマンド ラインに /d:DEBUG=True フラグを追加します。

• C# でトレースを有効にするには、コードのコンパイル時に /d:TRACE フラグをコンパイラのコマンド ラインに追加するか、#define TRACE をファイルの最上部に挿入します。Visual Basic では、コンパイラのコマンド ラインに /d:TRACE=True フラグを追加します。

リスナのレベルを設定するには、アプリケーションの構成ファイルを編集します。このファイルでは、リスナの追加、その型とパラメータの設定、リスナの削除、アプリケーションで以前設定されたすべてのリスナのクリアを実行できます。構成ファイルの書式は次の例のとおりです。

この例を実行するには、アセンブリの完全修飾名を指定する必要があります。アセンブリの完全修飾名を取得する方法については、「アセンブリ名」を参照してください。

<configuration>
    <system.diagnostics>
        <sharedListeners>
            <add name="FileLog"
                type="Microsoft.VisualBasic.Logging.FileLogTraceListener, Microsoft.VisualBasic,
 Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL"
 
                 initializeData="FileLogWriter"/>
        </sharedListeners>
    </system.diagnostics>
</configuration>

継承階層

System.Object
   System.MarshalByRefObject
     System.Diagnostics.TraceListener
      Microsoft.VisualBasic.Logging.FileLogTraceListener

スレッド セーフ

この型の 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

参照

関連項目
FileLogTraceListener メンバ
Microsoft.VisualBasic.Logging 名前空間
BaseFileName
TraceData
TraceEvent
Flush
Close
その他の技術情報
チュートリアル : My.Application.Log による情報の書き込み先の変更

FileLogTraceListener コンストラクタ ()

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

既定の名前を使用して、FileLogTraceListener クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.VisualBasic.Logging
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New FileLogTraceListener

C#

public FileLogTraceListener ()

C++

public:
FileLogTraceListener ()

J#

public FileLogTraceListener ()

JScript

public function FileLogTraceListener ()

解説

このメソッドは、FileLogTraceListener クラスのインスタンス名を FileLogTraceListener に設定します。

このインスタンス名には、Name プロパティを使用してアクセスできます。

プラットフォーム

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

参照

関連項目
FileLogTraceListener クラス
FileLogTraceListener メンバ
Microsoft.VisualBasic.Logging 名前空間
TraceListener
FileLogTraceListener クラス
その他の技術情報
My.Application.Log オブジェクト

FileLogTraceListener コンストラクタ

FileLogTraceListener クラスの新しいインスタンスを初期化し、その名前を設定します。
オーバーロードの一覧

名前	説明
FileLogTraceListener ()	既定の名前を使用して、FileLogTraceListener クラスの新しいインスタンスを初期化します。
FileLogTraceListener (String)	指定された名前を使用して、FileLogTraceListener クラスの新しいインスタンスを初期化します。

参照

関連項目

FileLogTraceListener クラス
FileLogTraceListener メンバ
Microsoft.VisualBasic.Logging 名前空間
TraceListener
FileLogTraceListener クラス

その他の技術情報

My.Application.Log オブジェクト

FileLogTraceListener コンストラクタ (String)

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

指定された名前を使用して、FileLogTraceListener クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.VisualBasic.Logging
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String _
)

Visual Basic (使用法)

Dim name As String

Dim instance As New FileLogTraceListener(name)

C#

public FileLogTraceListener (
    string name
)

C++

public:
FileLogTraceListener (
    String^ name
)

J#

public FileLogTraceListener (
    String name
)

JScript

public function FileLogTraceListener (
    name : String
)

パラメータ

name

String。インスタンス オブジェクトの名前。

解説

このメソッドは、FileLogTraceListener クラスのインスタンス名を name に設定します。

このインスタンス名には、Name プロパティを使用してアクセスできます。

プラットフォーム

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

参照

関連項目
FileLogTraceListener クラス
FileLogTraceListener メンバ
Microsoft.VisualBasic.Logging 名前空間
TraceListener
FileLogTraceListener クラス
その他の技術情報
My.Application.Log オブジェクト

FileLogTraceListener プロパティ

パブリック プロパティ

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

	名前	説明
	Append	現在のファイルに追記するか、新しいファイルに出力するかを決定します。
	Attributes	アプリケーション構成ファイルに定義されているカスタム トレース リスナ属性を取得します。 ( TraceListener から継承されます。)
	AutoFlush	ログ ファイル ストリームに書き込むたびに、バッファをフラッシュするかどうかを示します。
	BaseFileName	ログ ファイルの基本名を取得または設定します。ログ ファイルの完全名を生成するときに使用されます。
	CustomLocation	Location プロパティが Custom に設定されている場合に、ログ ファイルのディレクトリを取得または設定します。
	Delimiter	ログ メッセージに使用されているフィールド区切り記号を取得または設定します。
	DiskSpaceExhaustedBehavior	ログ ファイルへの出力時に、空きディスク容量が ReserveDiskSpace プロパティに指定された値を下回っていた場合の動作を決定します。
	Encoding	新しいログ ファイルを作成する際に使用するエンコーディングを取得または設定します。
	Filter	トレース リスナのトレース フィルタを取得および設定します。 ( TraceListener から継承されます。)
	FullLogFileName	現在のログ ファイルの完全名を取得します。
	IncludeHostName	ログを記録しているコンピュータのホスト名を出力に含めるかどうかを示します。
	IndentLevel	インデントのレベルを取得または設定します。 ( TraceListener から継承されます。)
	IndentSize	1 つのインデントに含まれる空白の数を取得または設定します。 ( TraceListener から継承されます。)
	IsThreadSafe	トレース リスナがスレッド セーフかどうかを示す値を取得します。 ( TraceListener から継承されます。)
	Location	ログ ファイルの場所を取得または設定します。
	LogFileCreationSchedule	ログ ファイルの名前に追加する日付を決定します。
	MaxFileSize	ログ ファイルの最大サイズ (バイト単位) を取得または設定します。
	Name	この TraceListener の名前を取得または設定します。 ( TraceListener から継承されます。)
	ReserveDiskSpace	確保する空きディスク容量 (バイト単位) を取得または設定します。この容量を下回ると、ログ ファイルにメッセージを出力できなくなります。
	TraceOutputOptions	トレース出力オプションを取得または設定します。 ( TraceListener から継承されます。)

プロテクト プロパティ

	名前	説明
	NeedIndent	出力にインデントを設定するかどうかを示す値を取得または設定します。 ( TraceListener から継承されます。)

参照

関連項目

FileLogTraceListener クラス
Microsoft.VisualBasic.Logging 名前空間
BaseFileName
TraceData
TraceEvent
Flush
Close

その他の技術情報

チュートリアル : My.Application.Log による情報の書き込み先の変更

FileLogTraceListener メソッド

パブリック メソッド

( プロテクト メソッド も参照)

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

プロテクト メソッド

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

参照

関連項目

FileLogTraceListener クラス
Microsoft.VisualBasic.Logging 名前空間
BaseFileName
TraceData
TraceEvent
Flush
Close

その他の技術情報

チュートリアル : My.Application.Log による情報の書き込み先の変更

FileLogTraceListener メンバ

ログ出力をファイルにリダイレクトするシンプルなリスナを提供します。

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

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

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

パブリック プロパティ

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

	名前	説明
	Append	現在のファイルに追記するか、新しいファイルに出力するかを決定します。
	Attributes	アプリケーション構成ファイルに定義されているカスタム トレース リスナ属性を取得します。(TraceListener から継承されます。)
	AutoFlush	ログ ファイル ストリームに書き込むたびに、バッファをフラッシュするかどうかを示します。
	BaseFileName	ログ ファイルの基本名を取得または設定します。ログ ファイルの完全名を生成するときに使用されます。
	CustomLocation	Location プロパティが Custom に設定されている場合に、ログ ファイルのディレクトリを取得または設定します。
	Delimiter	ログ メッセージに使用されているフィールド区切り記号を取得または設定します。
	DiskSpaceExhaustedBehavior	ログ ファイルへの出力時に、空きディスク容量が ReserveDiskSpace プロパティに指定された値を下回っていた場合の動作を決定します。
	Encoding	新しいログ ファイルを作成する際に使用するエンコーディングを取得または設定します。
	Filter	トレース リスナのトレース フィルタを取得および設定します。(TraceListener から継承されます。)
	FullLogFileName	現在のログ ファイルの完全名を取得します。
	IncludeHostName	ログを記録しているコンピュータのホスト名を出力に含めるかどうかを示します。
	IndentLevel	インデントのレベルを取得または設定します。(TraceListener から継承されます。)
	IndentSize	1 つのインデントに含まれる空白の数を取得または設定します。(TraceListener から継承されます。)
	IsThreadSafe	トレース リスナがスレッド セーフかどうかを示す値を取得します。 (TraceListener から継承されます。)
	Location	ログ ファイルの場所を取得または設定します。
	LogFileCreationSchedule	ログ ファイルの名前に追加する日付を決定します。
	MaxFileSize	ログ ファイルの最大サイズ (バイト単位) を取得または設定します。
	Name	この TraceListener の名前を取得または設定します。(TraceListener から継承されます。)
	ReserveDiskSpace	確保する空きディスク容量 (バイト単位) を取得または設定します。この容量を下回ると、ログ ファイルにメッセージを出力できなくなります。
	TraceOutputOptions	トレース出力オプションを取得または設定します。(TraceListener から継承されます。)

プロテクト プロパティ

	名前	説明
	NeedIndent	出力にインデントを設定するかどうかを示す値を取得または設定します。(TraceListener から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

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

プロテクト メソッド

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

参照

関連項目

FileLogTraceListener クラス
Microsoft.VisualBasic.Logging 名前空間
BaseFileName
TraceData
TraceEvent
Flush
Close

その他の技術情報

チュートリアル : My.Application.Log による情報の書き込み先の変更