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重写 、Commit、 Rollback和 Uninstall 方法。

• RunInstallerAttribute将 添加到派生类，并将其设置为 true。

• 将派生类放入程序集中，并安装应用程序。

• 调用安装程序。 例如，使用 InstallUtil.exe 调用安装程序。

属性 Installers 包含安装程序的集合。 如果 的 Installer 此实例是安装程序集合的一部分，则 Parent 属性设置为 Installer 包含该集合的 实例。 有关使用 集合的示例 Installers ，请参阅 AssemblyInstaller 类。

Install类的 Installer 、 Commit、 Rollback和 Uninstall 方法通过 属性中Installers存储的安装程序集合，并调用每个安装程序的相应方法。

Install不总是在同一Installer实例上调用 、Commit、 Rollback和 Uninstall 方法。 例如，安装和提交应用程序时可能会使用一 Installer 个实例，然后释放对该实例的引用。 稍后，卸载应用程序会创建对新 Installer 实例的引用，这意味着 Uninstall 该方法由 的其他实例 Installer调用。 因此，在派生类中，不要将计算机的状态保存在安装程序中。 请改用IDictionary跨调用保留并传递到 Install、、 CommitRollback和 Uninstall 方法中的 。

有两种情况说明需要在状态保存器 IDictionary中保存信息。 首先，假设安装程序设置了注册表项。 它应将密钥的原始值保存在 中 IDictionary。 如果回滚安装，则可以还原原始值。 其次，假设安装程序替换了现有文件。 将现有文件保存在临时目录中，并将该文件的新位置保存在 中 IDictionary。 如果回滚安装，则会删除较新的文件，并将其替换为临时位置中的原始文件。

属性 Installer.Context 包含有关安装的信息。 例如，有关安装日志文件的位置、用于保存方法所需 Uninstall 信息的文件的位置以及运行安装可执行文件时输入的命令行的信息。

另请参阅

• AssemblyInstaller
• ComponentInstaller
• InstallerCollection
• TransactedInstaller
• Installutil.exe（安装程序工具）