EventLog Класс

Определение

public ref class EventLog : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class EventLog : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type EventLog = class
    inherit Component
    interface ISupportInitialize

Public Class EventLog
Inherits Component
Implements ISupportInitialize

Наследование

Object

MarshalByRefObject

Component

EventLog

Реализации

ISupportInitialize

Примеры

В следующем примере создается источник MySource событий, если он еще не существует, и записывается запись в журнал MyNewLogсобытий .

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      //An event log source should not be created and immediately used.
      //There is a latency time to enable the source, it should be created
      //prior to executing the application that uses the source.
      //Execute this sample a second time to use the new source.
      EventLog::CreateEventSource( "MySource", "MyNewLog" );
      Console::WriteLine( "CreatingEventSource" );
      // The source is created.  Exit the application to allow it to be registered.
      return 0;
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Комментарии

EventLog позволяет получать доступ к журналам событий Windows или настраивать их, в которых записываются сведения о важных событиях программного обеспечения или оборудования. С помощью EventLogможно считывать существующие журналы, записывать записи в журналы, создавать или удалять источники событий, удалять журналы и реагировать на записи журнала. Вы также можете создавать новые журналы при создании источника событий.

Помимо предоставления доступа к отдельным журналам событий и их записям, EventLog класс позволяет получить доступ к коллекции всех журналов событий. Члены EventLog можно использовать для static удаления журналов, получения списков журналов, создания или удаления источника, а также определения того, содержит ли компьютер уже определенный источник.

Существует три журнала событий по умолчанию: Application, System и Security. Журнал безопасности доступен только для чтения. Другие приложения и службы, которые вы устанавливаете, например Active Directory, могут содержать дополнительные журналы событий.

При использовании EventLog класса существуют вопросы безопасности. EventLogтребуются EventLogPermission разрешения для определенных действий в платформа .NET Framework 2.0 и более поздних версий или полное доверие к платформа .NET Framework 1.0 и 1.1. Рекомендуется EventLogPermission не предоставлять коду с частичным доверием. Никогда не следует передавать объект журнала событий, включая EventLogEntryCollection объекты и EventLogEntry , менее доверенному коду. Например, создание EventLog объекта, запись записи, а затем передача EventLog объекта в частично доверенный код может создать проблему безопасности, так как возможность чтения и записи в журнал событий позволяет коду выполнять такие действия, как выдача сообщений журнала событий от имени другого приложения.

Начиная с Windows Vista контроль учетных записей (UAC) определяет учетные данные пользователя. Члену встроенной группы "Администраторы" присваивается два маркера доступа на время выполнения: маркер доступа обычного пользователя и маркер доступа администратора. По умолчанию назначена роль обычного пользователя. Чтобы запустить код, который обращается к журналу безопасности, необходимо сначала повысить уровень учетных данных от обычного пользователя до администратора. Это можно сделать при запуске приложения, открыв контекстное меню приложения (если вы используете мышь, щелкните правой кнопкой мыши значок приложения) и укажите, что вы хотите запустить от имени администратора.

Вы можете использовать для EventLog создания пользовательских журналов событий, которые можно просматривать с помощью Просмотр событий сервера. Используйте метод , RegisterDisplayName чтобы отобразить локализованное имя журнала событий в Просмотр событий. Используйте метод , ModifyOverflowPolicy чтобы настроить поведение журнала событий при достижении максимального размера журнала.

Для чтения из журнала событий укажите имя журнала (Log свойство) и имя компьютера сервера (MachineName свойство для журнала событий. Если не указать имя компьютера сервера, предполагается локальный компьютер . Нет необходимости указывать источник события (Source свойство ), так как источник требуется только для записи в журналы. Свойство Entries автоматически заполняется списком записей журнала событий.

Чтобы записать данные в журнал событий, укажите или создайте источник событий (Source свойство ). Чтобы создать новый источник событий, необходимо иметь учетные данные администратора на компьютере. Источник событий регистрирует приложение в журнале событий в качестве допустимого источника записей. Источник событий можно использовать для записи только в один журнал за раз. Свойство Source может быть любой случайной строкой, но имя должно отличаться от других источников на компьютере. Источником события обычно является имя приложения или другой идентифицируемой строки. При попытке создать повторяющееся Source значение возникает исключение. Однако один журнал событий может быть связан с несколькими источниками.

Если источник событий для журнала событий, связанного с экземпляром EventLog , не существует, создается новый источник событий. Чтобы создать источник событий в Windows Vista и более поздних версиях или Windows Server 2003, необходимо иметь учетные данные администратора.

Это требование связано с тем, что все журналы событий, включая журналы безопасности, должны выполняться поиск, чтобы определить, является ли источник событий уникальным. Начиная с Windows Vista пользователи не имеют разрешения на доступ к журналу безопасности; поэтому возникает SecurityException исключение .

Приложения и службы должны записывать данные в журнал приложений или в пользовательский журнал. Драйверы устройств должны записывать данные в системный журнал. Если свойство не задано явным Log образом, журнал событий по умолчанию будет использоваться в журнале приложений.

Используйте методы WriteEvent и WriteEntry для записи событий в журнал событий. Для записи событий необходимо указать источник событий; Необходимо создать и настроить источник событий перед записью первой записи с помощью источника.

Create новый источник событий во время установки приложения. Это позволяет операционной системе обновить список зарегистрированных источников событий и их конфигурацию. Если операционная система не обновила свой список источников событий и вы попытаетесь записать событие с новым источником, операция записи завершится ошибкой. Новый источник можно настроить с помощью EventLogInstaller объекта или CreateEventSource метода . Чтобы создать новый источник событий, необходимо иметь учетные данные администратора на компьютере.

Каждый источник может записывать данные только в один журнал событий одновременно; однако приложение может использовать несколько источников для записи в несколько журналов событий. Например, приложению может потребоваться несколько источников, настроенных для разных журналов событий или разных файлов ресурсов. Чтобы изменить сведения о конфигурации существующего источника, необходимо удалить источник, а затем создать его с новой конфигурацией. Если другие приложения или компоненты используют существующий источник, создайте новый источник с обновленной конфигурацией вместо удаления существующего источника.

Вы можете зарегистрировать источник событий с помощью локализованных ресурсов для вашей категории событий и строк сообщения. Приложение может записывать записи журнала событий, используя идентификаторы ресурсов вместо указания фактических строковых значений. Дополнительные сведения о настройке EventLogInstaller источника с помощью файлов ресурсов см. в классах и EventSourceCreationData .

Если приложение записывает строковые значения непосредственно в журнал событий, задавать свойства файла ресурсов для источника не требуется. Источник должен быть настроен либо для записи локализованных записей, либо для записи прямых строк. Если приложение записывает записи с использованием идентификаторов ресурсов и строковых значений, необходимо зарегистрировать два отдельных источника. Например, настройте один источник с файлами ресурсов, а затем используйте этот источник в методе WriteEvent для записи записей с помощью идентификаторов ресурсов в журнал событий. Затем создайте другой источник без файлов ресурсов и используйте этот источник в методе WriteEntry для записи строк непосредственно в журнал событий с помощью этого источника.

При записи событий необходимо как минимум указать строку сообщения или идентификатор ресурса для строки сообщения. Другие свойства события являются необязательными. Ниже приведены примеры необязательных параметров событий.

• Можно задать EventLogEntryType , чтобы указать значок, отображаемый Просмотр событий для записи.

• Можно указать идентификатор категории для события, если приложение использует категории для фильтрации событий.

• Вы можете прикрепить двоичные данные к записи события, если вы хотите связать дополнительные сведения с данным событием.

Список начальных значений свойств для экземпляра EventLogсм. в конструкторе EventLog .

Конструкторы

Свойства

Методы

События

Применяется к

См. также раздел

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase