EventLog.Log Свойство

Определение

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

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Пакет:

System.Diagnostics.EventLog v8.0.0

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

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.dll>

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

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, изменить свойство для этого EventLog свойства невозможноLog, не изменив Source значение или вызвав DeleteEventSource первым. Если изменить Log свойство после Source задания свойства, запись журнала вызывает исключение.

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

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

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

Внимание!

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

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

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