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

System.Management.Instrumentation.ManagementInstaller

示例

下面的示例演示如何使用 Installer 类。The following example demonstrates the use of the Installer class. 它创建一个继承自的类 Installer 。It creates a class which inherits from Installer. 当 Commit 完成时，将 Committing 发生事件并显示一条消息。When Commit is about to complete, Committing event occurs and a message is displayed. 若要使用 Installer 类，必须引用 System.Configu。 在项目中安装程序集。To use the Installer class, you must reference the System.Configuration.Install assembly in your project.

#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 中所有自定义安装程序的基类。This is the base class for all custom installers in the .NET Framework. 安装程序是帮助在计算机上安装应用程序的组件。Installers are components that help install applications on a computer.

若要使用，必须执行以下几个步骤 Installer ：There are several steps you must follow to use an Installer:

• 继承 Installer 类。Inherit the Installer class.

• 重写 Install 、 Commit 、 Rollback 和 Uninstall 方法。Override the Install, Commit, Rollback, and Uninstall methods.

• 将添加 RunInstallerAttribute 到派生类中，并将其设置为 true 。Add the RunInstallerAttribute to your derived class and set it to true.

• 将派生类放置在应用程序的程序集中，以便进行安装。Put your derived class in the assembly with your application to install.

• 调用安装程序。Invoke the installers. 例如，使用 InstallUtil.exe 调用安装程序。For example, use the InstallUtil.exe to invoke the installers.

Installers属性包含安装程序的集合。The Installers property contains a collection of installers. 如果此实例 Installer 为安装程序集合的一部分，则 Parent 属性设置为 Installer 包含集合的实例。If this instance of Installer is part of an installer collection, the Parent property is set to the Installer instance that contains the collection. 有关使用集合的示例 Installers ，请参阅 AssemblyInstaller 类。For an example of the use of the Installers collection, see the AssemblyInstaller class.

Install类的、、 Commit Rollback 和 Uninstall 方法 Installer 通过存储在属性中的安装程序的集合， Installers 并调用每个安装程序的相应方法。The Install, Commit, Rollback, and Uninstall methods of the Installer class go through the collection of installers stored in the Installers property, and invokes the corresponding method of each installer.

Install Commit Rollback Uninstall 不总是对同一实例调用、、和方法 Installer 。The Install, Commit, Rollback, and Uninstall methods are not always called on the same Installer instance. 例如，可以在 Installer 安装和提交应用程序时使用一个实例，然后释放对该实例的引用。For example, one Installer instance might be used while installing and committing an application, and then the reference to that instance is released. 稍后，卸载应用程序会创建对新实例的引用 Installer ，这意味着该 Uninstall 方法由不同的实例调用 Installer 。Later, uninstalling the application creates a reference to a new Installer instance, meaning that the Uninstall method is called by a different instance of Installer. 出于此原因，在派生类中，不要将计算机的状态保存在安装程序中。For this reason, in your derived class, do not save the state of a computer in an installer. 相反，请使用 IDictionary 跨调用保留并传入 Install 、 Commit 、 Rollback 和 Uninstall 方法的。Instead, use an IDictionary that is preserved across calls and passed into your Install, Commit, Rollback, and Uninstall methods.

两种情况阐释了在状态保护中保存信息的需要 IDictionary 。Two situations illustrate the need to save information in the state-saver IDictionary. 首先，假设安装程序设置了注册表项。First, suppose that your installer sets a registry key. 它应在中保存密钥的原始值 IDictionary 。It should save the key's original value in the IDictionary. 如果回滚安装，则可以还原原始值。If the installation is rolled back, the original value can be restored. 其次，假设安装程序替换了现有文件。Second, suppose the installer replaces an existing file. 将现有文件保存在临时目录中，并将该文件的新位置的位置保存在中 IDictionary 。Save the existing file in a temporary directory and the location of the new location of the file in the IDictionary. 如果安装已回滚，则会删除较新的文件，并将其替换为原位置。If the installation is rolled back, the newer file is deleted and replaced by the original from the temporary location.

Installer.Context属性包含有关安装的信息。The Installer.Context property contains information about the installation. 例如，有关安装的日志文件的位置、要保存方法所需信息的文件的位置， Uninstall 以及运行安装可执行文件时输入的命令行。For example, information about the location of the log file for the installation, the location of the file to save information required by the Uninstall method, and the command line that was entered when the installation executable was run.

构造函数

属性

方法

事件

适用于

另请参阅

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