EventLogInstaller.Install(IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет установку и записывает в реестр сведения о журнале событий.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install (System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Параметры
- stateSaver
- IDictionary
Класс IDictionary используется для сохранения сведений, которые необходимы для выполнения отката или операции удаления.
Исключения
Имя, указанное в свойстве Source, уже зарегистрировано для другого журнала событий.
Комментарии
Метод Install записывает сведения журнала событий в реестр и связывает журнал событий с журналом, заданным свойством Log . Если журнал еще не существует (и указан источник), Install создает журнал и связывает с ним новый источник.
Как правило, методы EventLogInstaller не вызываются из кода; они обычно вызываются только Installutil.exe (установщик). Средство автоматически вызывает Install метод в процессе установки для записи сведений реестра, связанных с устанавливаемым журналом событий. Установка является транзакционной, поэтому при сбое какого-либо компонента проекта установки во время установки все ранее установленные компоненты откатываются до состояния предварительной установки. Это достигается путем вызова метода каждого компонента Rollback .
Используйте EventLogInstaller для регистрации нового источника для нового или существующего журнала событий; не используйте для EventLogInstaller изменения существующего источника. Класс EventLogInstaller не изменяет свойства конфигурации существующего источника в соответствии с указанными свойствами установки. Метод Install создает исключение, если Source свойство соответствует имени источника, зарегистрированному для другого журнала событий на компьютере. Метод Install пропускает регистрацию источника, если Source свойство соответствует имени источника, которое уже зарегистрировано для того же журнала событий, указанного в свойстве Log .
Подпрограмма установки приложения использует свойство установщика Installer.Context проекта для автоматического хранения сведений о уже установленных компонентах. Эта информация о состоянии, передаваемая Install в stateSaver качестве параметра, постоянно обновляется по мере установки каждого EventLogInstallerсредства . Как правило, нет необходимости явно изменять эти сведения о состоянии в коде.
