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类。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.web程序集。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.

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

• 将添加true到派生类中, 并将其设置为。 RunInstallerAttributeAdd 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类的Rollback、 Commit、和Installers方法通过存储在属性中的安装程序的集合, 并调用每个安装程序的相应方法。 Uninstall InstallerThe 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.

Commit Rollback Uninstall不总是对同一Install实例调用、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)