EventLog.Source Свойство

Определение

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

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

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

EventLog.cs

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

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

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

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

Public Property Source As String

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

String

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

Атрибуты

SettingsBindableAttribute

Исключения

ArgumentException

Имя источника приводит к тому, что путь к разделу реестра превышает 254 символов.

Примеры

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

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("CreatingEventSource");
            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.");

        Console.WriteLine("Message written to event log.");
    }
}

Option Explicit
Option Strict
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
        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.")
        
        Console.WriteLine("Message written to event log.")
    End Sub
End Class

Комментарии

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

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

Замечание

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

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

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

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

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

При изменении Source значения, в котором она зарегистрирована, EventLog закрывается и выпускаются все дескриптора событий.

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

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

Замечание

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

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

• Log
• MachineName
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)