链接:https://msdn.microsoft.com/zh-cn/library/system.configuration.install.installer.aspx

Installer 类

提供自定义安装的基础。

命名空间:   System.Configuration.Install

程序集:  System.Configuration.Install(System.Configuration.Install.dll 中)

public class Installer : Component

  名称 说明
Installer()

初始化 Installer 类的新实例。

  名称 说明
CanRaiseEvents

获取一个指示组件是否可以引发事件的值。(从 Component 继承。)

Container

获取 IContainer,它包含 Component。(从 Component 继承。)

Context

获取或设置关于当前安装的信息。

DesignMode

获取一个值,用以指示 Component 当前是否处于设计模式。(从 Component 继承。)

Events

获取附加到此 Component 的事件处理程序的列表。(从 Component 继承。)

HelpText

获取安装程序集合中所有安装程序的帮助文字。

Installers

获取该安装程序包含的安装程序的集合。

Parent

获取或设置包含该安装程序所属的集合的安装程序。

Site

获取或设置 ComponentISite。(从 Component 继承。)

  名称 说明
Commit(IDictionary)

在派生类中重写时,完成安装事务。

CreateObjRef(Type)

创建一个对象,该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。(从
MarshalByRefObject 继承。)

Dispose()

释放由 Component 使用的所有资源。(从 Component 继承。)

Dispose(Boolean)

释放由 Component 占用的非托管资源,还可以另外再释放托管资源。(从 Component 继承。)

Equals(Object)

确定指定的对象是否等于当前对象。(从 Object 继承。)

Finalize()

在通过垃圾回收将 Component 回收之前,释放非托管资源并执行其他清理操作。(从 Component 继承。)

GetHashCode()

作为默认哈希函数。(从 Object 继承。)

GetLifetimeService()

检索控制此实例的生存期策略的当前生存期服务对象。(从 MarshalByRefObject 继承。)

GetService(Type)

返回一个对象,该对象表示由 Component 或它的 Container 提供的服务。(从 Component 继承。)

GetType()

获取当前实例的 Type。(从 Object 继承。)

InitializeLifetimeService()

获取控制此实例的生存期策略的生存期服务对象。(从 MarshalByRefObject 继承。)

Install(IDictionary)

在派生类中被重写时,执行安装。

MemberwiseClone()

创建当前 Object 的浅表副本。(从 Object 继承。)

MemberwiseClone(Boolean)

创建当前 MarshalByRefObject 对象的浅表副本。(从 MarshalByRefObject 继承。)

OnAfterInstall(IDictionary)

引发 AfterInstall 事件。

OnAfterRollback(IDictionary)

引发 AfterRollback 事件。

OnAfterUninstall(IDictionary)

引发 AfterUninstall 事件。

OnBeforeInstall(IDictionary)

引发 BeforeInstall 事件。

OnBeforeRollback(IDictionary)

引发 BeforeRollback 事件。

OnBeforeUninstall(IDictionary)

引发 BeforeUninstall 事件。

OnCommitted(IDictionary)

引发 Committed 事件。

OnCommitting(IDictionary)

引发 Committing 事件。

Rollback(IDictionary)

在派生类中重写时,还原计算机的安装前状态。

ToString()

返回包含 Component 的名称的 String(如果有)。不应重写此方法。(从 Component 继承。)

Uninstall(IDictionary)

在派生类中重写时,移除安装。

  名称 说明
AfterInstall

Installers 属性中的所有安装程序的 Install 方法都运行后发生。

AfterRollback

在回滚 Installers 属性中所有安装程序的安装后发生。

AfterUninstall

Installers 属性中所有安装程序都执行它们的卸载操作后发生。

BeforeInstall

在安装程序集合中每个安装程序的 Install 方法运行前发生。

BeforeRollback

在回滚 Installers 属性中的安装程序前发生。

BeforeUninstall

Installers 属性中的安装程序执行它们的卸载操作前发生。

Committed

Installers 属性中的所有安装程序均提交它们的安装后发生。

Committing

Installers 属性中的安装程序提交它们的安装前发生。

Disposed

当通过调用 Dispose 方法释放组件时发生。(从 Component 继承。)

这是.NET Framework 中的所有自定义安装程序类的基类。安装程序帮助的计算机上安装应用程序的组件。

有几个步骤必须遵循使用 Installer:

  • 继承 Installer 类。

  • 重写 Install, ,Commit, ,Rollback,
    ,和 Uninstall 方法。

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

  • 将您的派生的类放在具有您的应用程序若要安装的程序集。

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

Installers 属性包含安装程序的集合。如果此实例的
Installer 是安装程序集合的一部分 Parent 属性设置为 Installer 包含列的集合的实例。为举例说明如何使用
Installers 集合,请参阅 AssemblyInstaller 类。

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

Install, ,Commit,
Rollback, ,和
Uninstall 方法不会在同一个总是调用 Installer 实例。例如,一个
Installer 可能同时安装和提交应用程序中,使用实例,然后发布到该实例的引用。更高版本,卸载应用程序时将创建一个新的引用
Installer 实例,也就是说, Uninstall 方法由不同的实例调用 Installer。为此,在派生类中,不保存在一个安装程序中的计算机的状态。请改用
IDictionary ,它在调用之间保留并传递到您 Install, ,Commit, ,Rollback,
,和 Uninstall 方法。

两种情况下说明需要将信息保存在状态保护程序中 IDictionary。首先,假设您的安装程序设置一个注册表项。它应将保存的键中的原始值
IDictionary。如果安装被回滚,则可以还原原始值。其次,假定安装程序替换现有文件。将现有的文件保存在临时目录和文件中的新位置的位置中
IDictionary。如果安装被回滚,较新的文件被删除,并替换为从临时位置原始。

Installer.Context 属性包含有关安装的信息。例如,安装过程中,要保存所需的信息的文件的位置的日志文件的位置有关的信息
Uninstall 方法,并安装可执行文件运行时输入的命令行。

下面的示例演示如何使用 Installer 类。它将创建一个类,该类继承自
Installer。当
Commit 即将完成, Committing 事件发生并显示一条消息。若要使用
Installer 类中,您必须引用 System.Configuration.Install 您的项目中的程序集。

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 occured.");
Console.WriteLine("");
}
// Event handler for 'Committed' event.
private void MyInstaller_Committed(object sender, InstallEventArgs e)
{
Console.WriteLine("");
Console.WriteLine("Committed Event occured.");
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 ");
}
}

.NET Framework

1.1 后可用

此类型的任何公共静态(Visual Basic 中为 Shared)成员都是线程安全的。但不保证所有实例成员都是线程安全的。

返回页首

最新文章

  1. Session阻塞 读写锁引发的小问题
  2. shell tips
  3. 客户信贷管理&临时授信
  4. jquery easyui的异步tree
  5. Windows 7 Shortcuts (完整兼具分类有序,想我所想,赞!)
  6. 原生态Ajax实例
  7. Discuz X2.5 用户名包含被系统屏蔽的字符[解决方法]
  8. CSS中.和#区别
  9. android在假设绘制自己定义的bitmap,然后返回给ImageView
  10. MySQL日志文件之错误日志和慢查询日志详解
  11. 如何查看appache的端口是否被占用
  12. 微信小程序视频学习笔记
  13. CF961G Partitions
  14. String comparison is too slow in R language
  15. C语言函数入参压栈顺序为什么是从右向左?
  16. 20155302《网络对抗》Exp8 Web基础
  17. Spring Boot 1.4 单元测试
  18. 运行jsp常犯的错误
  19. FaceBook开源的词向量计算框架
  20. ZC_C++类函数指针_模拟_Delphi类函数指针_Qt例子

热门文章

  1. JDK源码解读之toUnsignedString
  2. 惩罚因子(penalty term)与损失函数(loss function)
  3. HTML结构文档中那些基础又重要又容易被忽略的事?
  4. 2016HUAS_ACM暑假集训1A - 士兵队列训练问题
  5. asp.net使用My97 Date Picker时设置默认起始时间为n年之前的今天
  6. FullCalendar只可以从外部拖入,内部不能互相拖动
  7. spring mvc 和 velocity整合
  8. Oracle存储过程 输出参数赋值异常:“Oracle.DataAccess.Types.OracleString”的类型初始值设定项引发异常。
  9. php数据库访问
  10. 编译错误:error: multi-line comment