EventLog.GetEventLogs メソッド

public:
 static cli::array <System::Diagnostics::EventLog ^> ^ GetEventLogs(System::String ^ machineName);

public static System.Diagnostics.EventLog[] GetEventLogs(string machineName);

static member GetEventLogs : string -> System.Diagnostics.EventLog[]

Public Shared Function GetEventLogs (machineName As String) As EventLog()

パラメーター

返品

指定したコンピューター上のログを表す EventLog 型の配列。

例外

例

次の例では、コンピューター "myServer" のログの一覧を取得します。 次に、各ログの名前を出力します。

using System;
using System.Diagnostics;

class MySample
{
    public static void Main()
    {
        EventLog[] remoteEventLogs;

        remoteEventLogs = EventLog.GetEventLogs("myServer");

        Console.WriteLine("Number of logs on computer: " + remoteEventLogs.Length);

        foreach (EventLog log in remoteEventLogs)
        {
            Console.WriteLine("Log: " + log.Log);
        }
    }
}

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        Dim remoteEventLogs() As EventLog

        remoteEventLogs = EventLog.GetEventLogs("myServer")

        Console.WriteLine(("Number of logs on computer: " & remoteEventLogs.Length))

        Dim log As EventLog
        For Each log In  remoteEventLogs
            Console.WriteLine(("Log: " & log.Log))
        Next log
    End Sub
End Class

注釈

EventLog オブジェクトの配列は、GetEventLogsの呼び出しが行われたときに、machineName パラメーターで指定されたコンピューター上のすべてのイベント ログのスナップショットです。 これは動的コレクションではないため、ログの削除や作成はリアルタイムで反映されません。 読み取りまたは書き込みを行う前に、配列にログが存在することを確認する必要があります。 配列には通常、少なくとも 3 つのログ (Application、System、Security) が含まれます。 指定したコンピューターでカスタム ログを作成した場合は、配列にも表示されます。

GetEventLogs は static メソッドであるため、 EventLog クラス自体で呼び出すことができます。 メソッドの呼び出しを行うために、 EventLog オブジェクトのインスタンスを作成する必要はありません。

イベント ログの一覧を取得するには、適切なレジストリアクセス許可が必要です。 これらのアクセス許可は、 Exists と SourceExistsを呼び出すために必要なアクセス許可と同じです。

こちらもご覧ください

• Exists(String)
• Log
• MachineName

public:
 static cli::array <System::Diagnostics::EventLog ^> ^ GetEventLogs();

public static System.Diagnostics.EventLog[] GetEventLogs();

static member GetEventLogs : unit -> System.Diagnostics.EventLog[]

Public Shared Function GetEventLogs () As EventLog()

返品

ローカル コンピューター上のログを表す EventLog 型の配列。

例外

例

次の例では、ローカル コンピューターで定義されているイベント ログを列挙し、各イベント ログの構成の詳細を表示します。

static void DisplayEventLogProperties()
{
    // Iterate through the current set of event log files,
    // displaying the property settings for each file.

    EventLog[] eventLogs = EventLog.GetEventLogs();
    foreach (EventLog e in eventLogs)
    {
        Int64 sizeKB = 0;

        Console.WriteLine();
        Console.WriteLine("{0}:", e.LogDisplayName);
        Console.WriteLine("  Log name = \t\t {0}", e.Log);

        Console.WriteLine("  Number of event log entries = {0}", e.Entries.Count.ToString());

        // Determine if there is an event log file for this event log.
        RegistryKey regEventLog = Registry.LocalMachine.OpenSubKey("System\\CurrentControlSet\\Services\\EventLog\\" + e.Log);
        if (regEventLog != null)
        {
            Object temp = regEventLog.GetValue("File");
            if (temp != null)
            {
                Console.WriteLine("  Log file path = \t {0}", temp.ToString());
                FileInfo file = new FileInfo(temp.ToString());

                // Get the current size of the event log file.
                if (file.Exists)
                {
                    sizeKB = file.Length / 1024;
                    if ((file.Length % 1024) != 0)
                    {
                        sizeKB++;
                    }
                    Console.WriteLine("  Current size = \t {0} kilobytes", sizeKB.ToString());
                }
            }
            else
            {
                Console.WriteLine("  Log file path = \t <not set>");
            }
        }

        // Display the maximum size and overflow settings.

        sizeKB = e.MaximumKilobytes;
        Console.WriteLine("  Maximum size = \t {0} kilobytes", sizeKB.ToString());
        Console.WriteLine("  Overflow setting = \t {0}", e.OverflowAction.ToString());

        switch (e.OverflowAction)
        {
            case OverflowAction.OverwriteOlder:
                Console.WriteLine("\t Entries are retained a minimum of {0} days.",
                    e.MinimumRetentionDays);
                break;
            case OverflowAction.DoNotOverwrite:
                Console.WriteLine("\t Older entries are not overwritten.");
                break;
            case OverflowAction.OverwriteAsNeeded:
                Console.WriteLine("\t If number of entries equals max size limit, a new event log entry overwrites the oldest entry.");
                break;
            default:
                break;
        }
    }
}

Shared Sub DisplayEventLogProperties()

   ' Iterate through the current set of event log files,
   ' displaying the property settings for each file.
   Dim eventLogs As EventLog() = EventLog.GetEventLogs()

   Dim e As EventLog
   For Each e In  eventLogs
      Dim sizeKB As Int64 = 0

      Console.WriteLine()
      Console.WriteLine("{0}:", e.LogDisplayName)
      Console.WriteLine("  Log name = " + ControlChars.Tab _
                          + ControlChars.Tab + " {0}", e.Log)

      Console.WriteLine("  Number of event log entries = {0}", e.Entries.Count.ToString())

      ' Determine if there is an event log file for this event log.
      Dim regEventLog As RegistryKey
      regEventLog = Registry.LocalMachine.OpenSubKey( _
             ("System\CurrentControlSet\Services\EventLog\" + e.Log))

      If Not (regEventLog Is Nothing) Then

         Dim temp As Object = regEventLog.GetValue("File")
         If Not (temp Is Nothing) Then

            Console.WriteLine("  Log file path = " + ControlChars.Tab _
                                  + " {0}", temp.ToString())
            Dim file As New FileInfo(temp.ToString())

            ' Get the current size of the event log file.
            If file.Exists Then
               sizeKB = file.Length / 1024
               If file.Length Mod 1024 <> 0 Then
                  sizeKB += 1
               End If
               Console.WriteLine("  Current size = " + ControlChars.Tab _
                          + " {0} kilobytes", sizeKB.ToString())
            End If
         Else
            Console.WriteLine("  Log file path = " + ControlChars.Tab _
                             + " <not set>")
         End If
      End If

      ' Display the maximum size and overflow settings.
      sizeKB = e.MaximumKilobytes
      Console.WriteLine("  Maximum size = " + ControlChars.Tab _
                         + " {0} kilobytes", sizeKB.ToString())
      Console.WriteLine("  Overflow setting = " + ControlChars.Tab _
                         + " {0}", e.OverflowAction.ToString())

      Select Case e.OverflowAction
         Case OverflowAction.OverwriteOlder
            Console.WriteLine(ControlChars.Tab + _
                 " Entries are retained a minimum of {0} days.", _
                 e.MinimumRetentionDays)
         Case OverflowAction.DoNotOverwrite
            Console.WriteLine(ControlChars.Tab + _
                 " Older entries are not overwritten.")
         Case OverflowAction.OverwriteAsNeeded
            Console.WriteLine(ControlChars.Tab + _
                 " If number of entries equals max size limit, a new event log entry overwrites the oldest entry.")
         Case Else
      End Select

   Next e

End Sub

注釈

EventLog オブジェクトの配列は、GetEventLogsの呼び出しが行われたときにローカル コンピューター上のすべてのイベント ログのスナップショットです。 これは動的コレクションではないため、ログの削除や作成はリアルタイムで反映されません。 読み取りまたは書き込みを行う前に、配列にログが存在することを確認する必要があります。 配列には通常、少なくとも 3 つのログ (Application、System、Security) が含まれます。 ローカル コンピューターでカスタム ログを作成した場合は、配列にも表示されます。

イベント ログの一覧を取得するには、適切なレジストリアクセス許可が必要です。 これらのアクセス許可は、 Exists と SourceExistsを呼び出すために必要なアクセス許可と同じです。

こちらもご覧ください

• Exists(String)
• Log