EventLog.Entries プロパティ

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

EventLog.Entries プロパティ

イベント ログの内容を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Entries As EventLogEntryCollection

Visual Basic (使用法)

Dim instance As EventLog
Dim value As EventLogEntryCollection

value = instance.Entries

C#

public EventLogEntryCollection Entries { get;
 }

C++

public:
property EventLogEntryCollection^ Entries {
    EventLogEntryCollection^ get ();
}

J#

/** @property */
public EventLogEntryCollection get_Entries ()

JScript

public function get Entries
 () : EventLogEntryCollection

プロパティ値
イベント ログのエントリを保持する EventLogEntryCollection。1 つのエントリが EventLogEntry クラスの 1 つのインスタンスに関連付けられます。

解説

イベント ログを読み取るときに、Entries メンバを使用します。

Entries は読み取り専用であるため、このプロパティを使用してエントリを変更したり、ログに書き込んだりすることはできません。代わりに Source を指定し、WriteEntry を呼び出して新しいログ エントリを書き込みます。Entries を使用して、イベント ログ内のエントリ数をカウントしたり、コレクション内の各 EventLogEntry を表示したりできます。インデックス付きの Item メンバを使用すると、Message、Category、TimeWritten、EntryType などの特定のエントリについての情報を取得できます。

ログから読み取るだけの場合は Source を指定する必要はありません。指定できるのは、EventLog インスタンスの Log 名のプロパティと MachineName (サーバー コンピュータ名) プロパティだけです。どちらの場合も、Entries メンバには自動的にイベント ログのエントリ リストが設定されます。このリストの項目に対応する適切なインデックスを選択することで、個別のエントリを読み取ることができます。

ログ エントリの読み取りと書き込みの重要な相違は、読み取りのときに読み取りメソッドを明示的に呼び出す必要がないことです。Log と MachineName を指定すると、Entries プロパティによって自動的にエントリが設定されます。Log プロパティまたは MachineName プロパティの値を変更した場合は、次回の読み取りで Entries プロパティが再び設定されます。

メモ
ログに接続している場合は MachineName を指定する必要はありません。MachineName を指定しなかった場合は、ローカル コンピュータ "." が想定されます。

使用例

ローカル コンピュータ上のイベント ログ "MyNewLog" のエントリを読み取る例を次に示します。

Visual Basic

Option Strict
Option Explicit

Imports System
Imports System.Diagnostics
Imports Microsoft.VisualBasic

Class MySample
    Public Shared Sub Main()
        
        Dim myLog As New
 EventLog()
        myLog.Log = "MyNewLog"
        Dim entry As EventLogEntry
        For Each entry In
  myLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry:
 " & entry.Message))
        Next entry
    End Sub ' Main
End Class ' MySample

C#

using System;
using System.Diagnostics;
              
class MySample{

    public static void Main(){

        EventLog myLog = new EventLog();
        myLog.Log = "MyNewLog";                      
        foreach(EventLogEntry entry in myLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }    
    }       
}
   

C++

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   EventLog^ myLog = gcnew EventLog;
   myLog->Log = "MyNewLog";
   System::Collections::IEnumerator^ myEnum = myLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

J#

import System.*;
import System.Diagnostics.*;
import System.Collections.*;

class MySample
{
    public static void main(String[]
 args)
    {
        EventLog myLog = new EventLog();
        myLog.set_Log("MyNewLog");
        EventLogEntry entry;
        IEnumerator objEnum = myLog.get_Entries().GetEnumerator();
        while (objEnum.MoveNext()) {
            entry = (EventLogEntry)objEnum.get_Current();
            Console.WriteLine("\tEntry: " + entry.get_Message());
        }
    } //main
} //MySample

.NET Framework のセキュリティ

• EventLogPermission  (コンピュータのイベント ログ情報の管理) EventLogPermissionAccess.Administer (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, 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、1.1、1.0

参照

関連項目
EventLog クラス
EventLog メンバ
System.Diagnostics 名前空間
EventLogEntryCollection
EventLogEntry
Source
Log
MachineName
WriteEntry