ServiceProcessInstaller 类

定义

public ref class ServiceProcessInstaller : System::Configuration::Install::ComponentInstaller

public class ServiceProcessInstaller : System.Configuration.Install.ComponentInstaller

type ServiceProcessInstaller = class
    inherit ComponentInstaller

Public Class ServiceProcessInstaller
Inherits ComponentInstaller

继承

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

示例

以下示例创建一个名为 MyProjectInstaller 的项目安装程序，该安装程序继承自 Installer. 假设有一个服务可执行文件，其中包含两个服务“Hello-World 服务 1”和“Hello-World 服务 2”。 在 MyProjectInstaller（由安装实用工具调用）的构造函数中， ServiceInstaller 为每个服务创建对象，并为可执行文件创建一个 ServiceProcessInstaller 对象。 要使安装实用工具将 MyProjectInstaller 识别为有效的安装程序，属性 RunInstallerAttribute 设置为 true。

在将安装程序添加到 Installers 集合之前，将在进程安装程序和服务安装程序上设置可选属性。 当安装实用工具访问 MyProjectInstaller 时，将通过调用Installers添加到InstallerCollection.Add集合的对象反过来安装。 在此过程中，安装程序会维护状态信息，指示已安装了哪些对象，因此在安装失败时，可以依次备份每个对象。

通常，不会显式实例化项目安装程序类。 你将创建它并添加 RunInstallerAttribute安装实用工具，但安装实用工具实际上会调用该类，因此实例化该类。

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

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

[RunInstaller(true)]
public ref class MyProjectInstaller : public Installer
{
private:
    ServiceInstaller^ serviceInstaller1;
    ServiceInstaller^ serviceInstaller2;
    ServiceProcessInstaller^ processInstaller;

public:
    MyProjectInstaller()
    {
        // Instantiate installers for process and services.
        processInstaller = gcnew ServiceProcessInstaller;
        serviceInstaller1 = gcnew ServiceInstaller;
        serviceInstaller2 = gcnew ServiceInstaller;

        // The services run under the system account.
        processInstaller->Account = ServiceAccount::LocalSystem;

        // The services are started manually.
        serviceInstaller1->StartType = ServiceStartMode::Manual;
        serviceInstaller2->StartType = ServiceStartMode::Manual;

        // ServiceName must equal those on ServiceBase derived classes.
        serviceInstaller1->ServiceName = "Hello-World Service 1";
        serviceInstaller2->ServiceName = "Hello-World Service 2";

        // Add installers to collection. Order is not important.
        Installers->Add( serviceInstaller1 );
        Installers->Add( serviceInstaller2 );
        Installers->Add( processInstaller );
    }

    static void Main()
    {
        Console::WriteLine("Usage: InstallUtil.exe [<service>.exe]");
    }
};

int main()
{
    MyProjectInstaller::Main();
}

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

[RunInstaller(true)]
public class MyProjectInstaller : Installer
{
    private ServiceInstaller serviceInstaller1;
    private ServiceInstaller serviceInstaller2;
    private ServiceProcessInstaller processInstaller;

    public MyProjectInstaller()
    {
        // Instantiate installers for process and services.
        processInstaller = new ServiceProcessInstaller();
        serviceInstaller1 = new ServiceInstaller();
        serviceInstaller2 = new ServiceInstaller();

        // The services run under the system account.
        processInstaller.Account = ServiceAccount.LocalSystem;

        // The services are started manually.
        serviceInstaller1.StartType = ServiceStartMode.Manual;
        serviceInstaller2.StartType = ServiceStartMode.Manual;

        // ServiceName must equal those on ServiceBase derived classes.
        serviceInstaller1.ServiceName = "Hello-World Service 1";
        serviceInstaller2.ServiceName = "Hello-World Service 2";

        // Add installers to collection. Order is not important.
        Installers.Add(serviceInstaller1);
        Installers.Add(serviceInstaller2);
        Installers.Add(processInstaller);
    }

    public static void Main()
    {
        Console.WriteLine("Usage: InstallUtil.exe [<service>.exe]");
    }
}

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

<RunInstallerAttribute(True)> _
Public Class MyProjectInstaller
    Inherits Installer
    Private serviceInstaller1 As ServiceInstaller
    Private serviceInstaller2 As ServiceInstaller
    Private processInstaller As ServiceProcessInstaller    
    
    Public Sub New()
        ' Instantiate installers for process and services.
        processInstaller = New ServiceProcessInstaller()
        serviceInstaller1 = New ServiceInstaller()
        serviceInstaller2 = New ServiceInstaller()
        
        ' The services will run under the system account.
        processInstaller.Account = ServiceAccount.LocalSystem
        
        ' The services will be started manually.
        serviceInstaller1.StartType = ServiceStartMode.Manual
        serviceInstaller2.StartType = ServiceStartMode.Manual
        
        ' ServiceName must equal those on ServiceBase derived classes.            
        serviceInstaller1.ServiceName = "Hello-World Service 1"
        serviceInstaller2.ServiceName = "Hello-World Service 2"
        
        ' Add installers to collection. Order is not important.
        Installers.Add(serviceInstaller1)
        Installers.Add(serviceInstaller2)
        Installers.Add(processInstaller)
    End Sub

    Public Shared Sub Main()
        Console.WriteLine("Usage: InstallUtil.exe [<service>.exe]")
    End Sub
End Class

注解

该 ServiceProcessInstaller 操作适用于可执行文件中的所有服务。 安装实用工具使用它来编写与要安装的服务关联的注册表值。

若要安装服务，请创建一个继承自 Installer的项目安装程序类，并将该类设置为 RunInstallerAttributetrue。 在项目中，为每个服务应用程序实例化一ServiceProcessInstaller个ServiceInstaller实例，并为应用程序中的每个服务实例实例。 最后，将 ServiceProcessInstaller 实例和 ServiceInstaller 实例添加到项目安装程序类。

InstallUtil.exe 运行时，实用工具会在服务程序集中查找设置为 <a0/> 的类。 通过将类添加到与项目安装程序关联的集合，将类添加到 Installers 服务程序集。 RunInstallerAttribute如果是false，安装实用工具将忽略项目安装程序。

对于实例 ServiceProcessInstaller，可以修改的属性包括指定服务应用程序在登录用户以外的帐户下运行。 可以指定服务应运行的特定 Username 和 Password 对，或者可用于 Account 指定服务在计算机的系统帐户、本地或网络服务帐户或用户帐户下运行。

通常，你不会在代码中调用方法 ServiceInstaller ;它们通常仅由安装实用工具调用。 安装实用工具会在安装过程中自动调用 ServiceProcessInstaller.Install 和 ServiceInstaller.Install 方法。 如有必要，它会通过调用以前安装的所有组件（ Rollback 或 ServiceInstaller.Rollback）来回退故障。

应用程序的安装例程使用项目安装程序 Installer.Context自动维护已安装组件的相关信息。 此状态信息会持续更新， ServiceProcessInstaller 因为实例和每个 ServiceInstaller 实例都由实用工具安装。 通常不需要代码显式修改此状态信息。

实例化 ServiceProcessInstaller 导致调用基类构造函数 ComponentInstaller。

另请参阅

• ServiceInstaller
• ServiceBase
• ComponentInstaller
• Installers
• ServiceAccount
• ServiceInstallerDialog