EventLogInstaller.Source Свойство

Определение

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

System.Diagnostics

Сборка:

System.Configuration.Install.dll

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

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

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set

Public Property Source As String

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

String

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

Атрибуты

TypeConverterAttribute

Комментарии

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

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

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

Используйте для регистрации нового источника для нового или существующего журнала событий; не используйте EventLogInstallerEventLogInstaller для изменения существующего источника. Класс EventLogInstaller не изменяет свойства конфигурации существующего источника в соответствии с указанными свойствами установки. Метод Install вызывает исключение, если Source свойство соответствует исходному имени, зарегистрированному для другого журнала событий на компьютере. Метод Install не регистрирует источник, если Source свойство соответствует исходному имени, которое уже зарегистрировано для того же журнала событий, указанного в свойстве Log .

Дополнительные сведения о поведении журналов событий и источников смEventLog. в документации по классам и Source свойствамLog.

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

• Source
• EventLog