Installer Класс

Определение

public ref class Installer : System::ComponentModel::Component

public class Installer : System.ComponentModel.Component

type Installer = class
    inherit Component

Public Class Installer
Inherits Component

Наследование

Object

MarshalByRefObject

Component

Installer

Производный

System.Configuration.Install.AssemblyInstaller

System.Configuration.Install.ComponentInstaller

System.Configuration.Install.TransactedInstaller

System.Management.Instrumentation.DefaultManagementInstaller

System.Management.Instrumentation.DefaultManagementProjectInstaller

Подробнее…

Примеры

В следующем примере показано использование Installer класса. Он создает класс, от которого наследуется Installer. Когда Commit будет завершено, Committing происходит событие и отображается сообщение. Чтобы использовать Installer класс, необходимо ссылаться на сборку System.Configuration.Install в проекте.

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::Configuration::Install;

// Set 'RunInstaller' attribute to true.

[RunInstaller(true)]
ref class MyInstallerClass: public Installer
{
private:

   // Event handler for 'Committing' event.
   void MyInstaller_Committing( Object^ sender, InstallEventArgs^ e )
   {
      Console::WriteLine( "" );
      Console::WriteLine( "Committing Event occurred." );
      Console::WriteLine( "" );
   }


   // Event handler for 'Committed' event.
   void MyInstaller_Committed( Object^ sender, InstallEventArgs^ e )
   {
      Console::WriteLine( "" );
      Console::WriteLine( "Committed Event occurred." );
      Console::WriteLine( "" );
   }


public:
   MyInstallerClass()
   {
      
      // Attach the 'Committed' event.
      this->Committed += gcnew InstallEventHandler( this, &MyInstallerClass::MyInstaller_Committed );
      
      // Attach the 'Committing' event.
      this->Committing += gcnew InstallEventHandler( this, &MyInstallerClass::MyInstaller_Committing );
   }


   // Override the 'Install' method.
   virtual void Install( IDictionary^ savedState ) override
   {
      Installer::Install( savedState );
   }


   // Override the 'Commit' method.
   virtual void Commit( IDictionary^ savedState ) override
   {
      Installer::Commit( savedState );
   }


   // Override the 'Rollback' method.
   virtual void Rollback( IDictionary^ savedState ) override
   {
      Installer::Rollback( savedState );
   }

};

int main()
{
   Console::WriteLine( "Usage : installutil.exe Installer.exe " );
}

using System;
using System.Collections;
using System.ComponentModel;
using System.Configuration.Install;

// Set 'RunInstaller' attribute to true.
[RunInstaller(true)]
public class MyInstallerClass: Installer
{
   public MyInstallerClass() :base()
   {
      // Attach the 'Committed' event.
      this.Committed += new InstallEventHandler(MyInstaller_Committed);
      // Attach the 'Committing' event.
      this.Committing += new InstallEventHandler(MyInstaller_Committing);
   }
   // Event handler for 'Committing' event.
   private void MyInstaller_Committing(object sender, InstallEventArgs e)
   {
      Console.WriteLine("");
      Console.WriteLine("Committing Event occurred.");
      Console.WriteLine("");
   }
   // Event handler for 'Committed' event.
   private void MyInstaller_Committed(object sender, InstallEventArgs e)
   {
      Console.WriteLine("");
      Console.WriteLine("Committed Event occurred.");
      Console.WriteLine("");
   }
   // Override the 'Install' method.
   public override void Install(IDictionary savedState)
   {
      base.Install(savedState);
   }
   // Override the 'Commit' method.
   public override void Commit(IDictionary savedState)
   {
      base.Commit(savedState);
   }
   // Override the 'Rollback' method.
   public override void Rollback(IDictionary savedState)
   {
      base.Rollback(savedState);
   }
   public static void Main()
   {
      Console.WriteLine("Usage : installutil.exe Installer.exe ");
   }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Configuration.Install

' Set 'RunInstaller' attribute to true.
<RunInstaller(True)> _
Public Class MyInstallerClass
   Inherits Installer

   Public Sub New()
       MyBase.New()
      ' Attach the 'Committed' event.
      AddHandler Me.Committed, AddressOf MyInstaller_Committed
      ' Attach the 'Committing' event.
      AddHandler Me.Committing, AddressOf MyInstaller_Committing
   End Sub

   ' Event handler for 'Committing' event.
   Private Sub MyInstaller_Committing(ByVal sender As Object, _
                                      ByVal e As InstallEventArgs)
      Console.WriteLine("")
      Console.WriteLine("Committing Event occurred.")
      Console.WriteLine("")
   End Sub

   ' Event handler for 'Committed' event.
   Private Sub MyInstaller_Committed(ByVal sender As Object, _
                                     ByVal e As InstallEventArgs)
      Console.WriteLine("")
      Console.WriteLine("Committed Event occurred.")
      Console.WriteLine("")
   End Sub

   ' Override the 'Install' method.
   Public Overrides Sub Install(ByVal savedState As IDictionary)
      MyBase.Install(savedState)
   End Sub

   ' Override the 'Commit' method.
   Public Overrides Sub Commit(ByVal savedState As IDictionary)
      MyBase.Commit(savedState)
   End Sub

   ' Override the 'Rollback' method.
   Public Overrides Sub Rollback(ByVal savedState As IDictionary)
      MyBase.Rollback(savedState)
   End Sub
   Public Shared Sub Main()
      Console.WriteLine("Usage : installutil.exe Installer.exe ")
   End Sub
End Class

Комментарии

Это базовый класс для всех пользовательских установщиков в .NET Framework. Установщики — это компоненты, которые помогают устанавливать приложения на компьютере.

Существует несколько шагов, которые необходимо выполнить для использования Installer:

• Installer Наследование класса.

• Переопределите Installметоды , CommitRollbackи Uninstall методы.

• Добавьте в производный RunInstallerAttribute класс и задайте для него значение true.

• Поместите производный класс в сборку с приложением для установки.

• Вызов установщиков. Например, используйте InstallUtil.exe для вызова установщиков.

Свойство Installers содержит коллекцию установщиков. Если этот экземпляр является частью коллекции установщика Installer , Parent свойство задается Installer экземпляром, содержащим коллекцию. Пример использования Installers коллекции см. в AssemblyInstaller классе.

Методы InstallRollbackCommitи Uninstall методы Installer класса проходят через коллекцию установщиков, хранящихся в Installers свойстве, и вызывает соответствующий метод каждого установщика.

Методы Install, RollbackCommitи Uninstall методы не всегда вызываются в одном Installer экземпляре. Например, при установке и фиксации приложения может использоваться один Installer экземпляр, а затем выпущена ссылка на этот экземпляр. Позже удаление приложения создает ссылку на новый Installer экземпляр, что означает, что Uninstall метод вызывается другим экземпляром Installer. По этой причине в производном классе не сохраняйте состояние компьютера в установщике. Вместо этого используйте функциюIDictionary, которая сохраняется во всех вызовах и передается в методы , CommitRollbackи Uninstall в негоInstall.

Две ситуации иллюстрируют необходимость сохранения информации в хранимом IDictionaryсостоянии. Сначала предположим, что установщик задает раздел реестра. Он должен сохранить исходное значение ключа в файле IDictionary. Если установка откатится, исходное значение можно восстановить. Во-вторых, предположим, что установщик заменяет существующий файл. Сохраните существующий файл во временном каталоге и расположение нового расположения файла в каталоге IDictionary. Если установка откатится, новый файл удаляется и заменяется исходным из временного расположения.

Свойство Installer.Context содержит сведения об установке. Например, сведения о расположении файла журнала для установки, расположении файла для сохранения сведений, необходимых Uninstall методу, и командной строке, введенной при запуске исполняемого файла установки.

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

• AssemblyInstaller
• ComponentInstaller
• InstallerCollection
• TransactedInstaller
• Installutil.exe (средство установщика)