EventLog.Log Свойство

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Исходный код:

EventLog.cs

Возвращает или задает имя журнала для чтения или записи.

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public string Log { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.Log : string with get, set

Public Property Log As String

Значение свойства

String

Имя журнала. Это может быть приложение, система, безопасность или пользовательское имя журнала. Значение по умолчанию — пустая строка ("").

Атрибуты

SettingsBindableAttribute

Примеры

Следующий пример считывает записи в журнале событий NewEventLog на локальном компьютере.

using System;
using System.Diagnostics;

class MySample{

    public static void Main(){

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

Imports System.Diagnostics

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

Комментарии

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

Замечание

Имена журналов ограничены восемью символами. Согласно системе, MyLogSample1 и MyLogSample2 являются одинаковыми журналами.

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

Замечание

Если вы подключаетесь к журналу, не требуется указывать MachineName . Если этот параметр не указан, предполагается, что локальный MachineNameкомпьютер (".") предполагается.

Source Если свойство не задано, вызов Log возвращает пустую строку, если Log она не была явно задана (задав Log свойство или через конструктор). Source Если задано, Log возвращает имя журнала, в который был зарегистрирован этот источник.

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

Операционная система хранит журналы событий в виде файлов. При использовании EventLogInstaller или CreateEventSource создании нового журнала событий связанный файл хранится в каталоге %SystemRoot%\System32\Config на указанном компьютере. Имя файла задается путем добавления первых 8 символов Log свойства с расширением имени файла EVT.

Создать журнал нельзя только с помощью Log свойства (без указания источника для журнала). Можно вызвать CreateEventSource, передать новое имя журнала в качестве параметра, а затем вызвать DeleteEventSource. Однако намерение обычно заключается в создании (и записи записей в) новых журналов, относящихся к приложению, или для чтения из существующих журналов.

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

Предостережение

Если для свойства задано Log имя журнала, который не существует, система присоединяет EventLog его к журналу приложений, но не предупреждает, что он использует журнал, отличный от указанного.

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

• MachineName
• Source
• Entries
• Exists(String)
• Delete(String)
• CreateEventSource
• EventLogEntryCollection