EventLogInstaller.Log Свойство

Определение

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

System.Diagnostics

Сборка:

System.Configuration.Install.dll

Получает или задает имя журнала, для которого задается источник.

public:
 property System::String ^ Log { 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 Log { get; set; }

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

Public Property Log As String

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

String

Имя журнала. Существуют следующие имена: журнал приложения, журнал системы или имя, указанное пользователем. Значение по умолчанию — пустая строка ("").

Атрибуты

TypeConverterAttribute

Комментарии

С помощью Log свойства можно связать источник, указанный в свойстве Source , с существующим или новым журналом на локальном компьютере. Installutil.exe (установщик) использует эти сведения для сопоставления источника с журналом в реестре компьютера. Приложения и службы должны записывать данные в журнал приложений или пользовательский журнал. Драйверы устройств должны записывать данные в системный журнал.

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

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

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

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

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

• Log
• EventLog