ServiceProcessInstaller Classe

Definição

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

Herança

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

Exemplos

O exemplo a seguir cria um instalador de projeto chamado MyProjectInstaller, que herda de Installer. Supõe-se que há um executável de serviço que contém dois serviços, "Hello-World Service 1" e "Hello-World Service 2". Dentro do construtor para MyProjectInstaller (que seria chamado pelo utilitário de instalação), ServiceInstaller os objetos são criados para cada serviço e um ServiceProcessInstaller é criado para o executável. Para que o utilitário de instalação reconheça MyProjectInstaller como um instalador válido, o RunInstallerAttribute atributo é definido truecomo .

As propriedades opcionais são definidas no instalador do processo e nos instaladores de serviço antes que os instaladores sejam adicionados à Installers coleção. Quando o utilitário de instalação acessar MyProjectInstaller, os objetos adicionados à Installers coleção por meio de uma chamada serão InstallerCollection.Add instalados por sua vez. Durante o processo, o instalador mantém informações de estado indicando quais objetos foram instalados, de modo que cada objeto pode ser retirado em caso de falha de instalação.

Normalmente, você não instanciaria explicitamente a classe do instalador de projeto. Você o criaria e adicionaria a RunInstallerAttributeclasse , mas o utilitário de instalação realmente chama e, portanto, instancia a classe.

#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

Comentários

O ServiceProcessInstaller trabalho é comum a todos os serviços em um executável. Ele é usado pelo utilitário de instalação para gravar valores de registro associados aos serviços que você deseja instalar.

Para instalar um serviço, crie uma classe de instalador de Installerprojeto que herda e defina a RunInstallerAttribute classe como true. Em seu projeto, instancie uma ServiceProcessInstaller instância por aplicativo de serviço e uma ServiceInstaller instância para cada serviço no aplicativo. Por fim, adicione a ServiceProcessInstaller instância e as ServiceInstaller instâncias à classe do instalador de projeto.

Quando InstallUtil.exe é executado, o utilitário procura classes no assembly de serviço com o RunInstallerAttribute conjunto como true. Adicione classes ao assembly de serviço adicionando-as Installers à coleção associada ao instalador do projeto. Se RunInstallerAttribute estiver false, o utilitário de instalação ignorará o instalador do projeto.

Para uma instância de ServiceProcessInstaller, as propriedades que você pode modificar incluem especificar que um aplicativo de serviço seja executado em uma conta diferente do usuário conectado. Você pode especificar um par e Password específico Username no qual o serviço deve ser executado ou você pode usar Account para especificar que o serviço seja executado na conta do sistema do computador, em uma conta de serviço local ou de rede ou em uma conta de usuário.

Normalmente, você não chama os métodos em ServiceInstaller seu código; eles geralmente são chamados apenas pelo utilitário de instalação. O utilitário de instalação chama automaticamente os métodos e ServiceProcessInstaller.Install os ServiceInstaller.Install métodos durante o processo de instalação. Ele faz backup de falhas, se necessário, chamando Rollback (ou ServiceInstaller.Rollback) em todos os componentes instalados anteriormente.

A rotina de instalação de um aplicativo mantém informações automaticamente sobre os componentes já instalados, usando o instalador do Installer.Contextprojeto. Essas informações de estado são atualizadas continuamente à medida que a ServiceProcessInstaller instância e cada ServiceInstaller instância é instalada pelo utilitário. Geralmente, é desnecessário que seu código modifique explicitamente essas informações de estado.

A instanciação de um ServiceProcessInstaller faz com que o construtor ComponentInstallerde classe base seja chamado.

Confira também

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