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 в этом журнале, но журнал не создается, пока в него не будет записана первая запись.

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

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

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

• Source
• EventLog