EventSourceCreationData.LogName Свойство

Определение

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

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

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

EventSourceCreationData.cs

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

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

public string LogName { get; set; }

member this.LogName : string with get, set

Public Property LogName As String

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

String

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

Примеры

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

EventSourceCreationData mySourceData = new EventSourceCreationData("", "");
bool registerSource = true;

// Process input parameters.
if (args.Length > 0)
{
    // Require at least the source name.

    mySourceData.Source = args[0];

    if (args.Length > 1)
    {
        mySourceData.LogName = args[1];
    }

    if (args.Length > 2)
    {
        mySourceData.MachineName = args[2];
    }
    if ((args.Length > 3) && (args[3].Length > 0))
    {
        mySourceData.MessageResourceFile = args[3];
    }
}
else
{
    // Display a syntax help message.
    Console.WriteLine("Input:");
    Console.WriteLine(" source [event log] [machine name] [resource file]");

    registerSource = false;
}

// Set defaults for parameters missing input.
if (mySourceData.MachineName.Length == 0)
{
    // Default to the local computer.
    mySourceData.MachineName = ".";
}
if (mySourceData.LogName.Length == 0)
{
    // Default to the Application log.
    mySourceData.LogName = "Application";
}

         Dim mySourceData As EventSourceCreationData = new EventSourceCreationData("", "")
         Dim registerSource As Boolean = True

         ' Process input parameters.
         If args.Length > 0
             ' Require at least the source name.

             mySourceData.Source = args(0)

             If args.Length > 1

                 mySourceData.LogName = args(1)
 
             End If
             If args.Length > 2

                 mySourceData.MachineName = args(2)
 
             End If
             If args.Length > 3 AndAlso args(3).Length > 0

                 mySourceData.MessageResourceFile = args(3)
 
             End If

         Else 
             ' Display a syntax help message.
             Console.WriteLine("Input:")
             Console.WriteLine(" source [event log] [machine name] [resource file]")

             registerSource = False
         End If

         ' Set defaults for parameters missing input.
         If mySourceData.MachineName.Length = 0
         
             ' Default to the local computer.
             mySourceData.MachineName = "."
         End If
         If mySourceData.LogName.Length = 0
             ' Default to the Application log.
             mySourceData.LogName = "Application"
         End If

Комментарии

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

Замечание

Журнал безопасности доступен только для чтения.

Чтобы выбрать существующий журнал для нового источника, задайте LogName для свойства имя существующего журнала событий. Чтобы создать новый журнал событий для источника, необходимо задать LogName свойство. Имена журналов событий должны состоять из печатных символов и не могут содержать символы "*", "?" или "\". Первые 8 символов имени журнала событий должны отличаться от первых 8 символов существующих имен журналов событий на указанном компьютере.

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

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

• Log
• Exists(String)