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 .
Используйте для регистрации нового источника для нового или существующего журнала событий; не используйте EventLogInstallerEventLogInstaller для изменения существующего источника. Класс EventLogInstaller не изменяет свойства конфигурации существующего источника в соответствии с указанными свойствами установки. Метод Install вызывает исключение, если Source свойство соответствует исходному имени, зарегистрированному для другого журнала событий на компьютере. Метод Install пропускает регистрацию источника, если Source свойство соответствует имени источника, которое уже зарегистрировано для того же журнала событий, указанного в свойстве Log .
Подпрограмма установки приложения использует свойство установщика Installer.Context проекта для автоматического обслуживания сведений о компонентах, которые уже установлены. Эти сведения о состоянии, передаваемые Install в качестве stateSaver параметра, постоянно обновляются при установке каждого EventLogInstallerсредства. Как правило, коду не требуется явно изменять эти сведения о состоянии.
