EventLog.Entries プロパティとは何？わかりやすく解説 Weblio辞書

.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

public EventLogEntryCollection Entries { get;
 }

C++

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

/** @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

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 );
   }
}

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