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 seguinte cria um instalador de projeto chamado MyProjectInstaller, que herda de Installer. Assume-se que existe um executável de serviço que contém dois serviços, "Hello-World Serviço 1" e "Hello-World Serviço 2". No construtor do MyProjectInstaller (que seria chamado pela utilidade de instalação), ServiceInstaller são criados objetos para cada serviço, e um ServiceProcessInstaller é criado para o executável. Para que a utilidade de instalação reconheça o MyProjectInstaller como um instalador válido, o RunInstallerAttribute atributo é definido como true.

As propriedades opcionais são definidas no instalador do processo e nos instaladores de serviço antes de estes serem adicionados à Installers coleção. Quando a utilidade de instalação acede ao MyProjectInstaller, os objetos adicionados à Installers coleção através de uma chamada a InstallerCollection.Add serão instalados por sua vez. Durante o processo, o instalador mantém informações de estado indicando quais os objetos instalados, para que cada objeto possa ser retirado em caso de falha na instalação.

Normalmente, não instanciaria explicitamente a sua classe de instalador de projeto. Criarias e adicionarias o RunInstallerAttribute, mas a utilidade de instalação 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

Observações

O ServiceProcessInstaller trabalho é comum a todos os serviços num executável. É usado pela utilidade de instalação para escrever valores de registo associados aos serviços que pretende instalar.

Para instalar um serviço, crie uma classe de instalador de projeto que herde de Installer, e defina a RunInstallerAttribute classe na classe para true. No seu projeto, instância por ServiceProcessInstaller aplicação de serviço e uma ServiceInstaller instância para cada serviço da aplicação. Por fim, adiciona a ServiceProcessInstaller instância e as ServiceInstaller instâncias à tua classe de instalador de projetos.

Quando InstallUtil.exe corre, a utilitária procura classes na assembly de serviço com o RunInstallerAttribute conjunto em true. Adicione classes ao conjunto do serviço adicionando-as à Installers coleção associada ao seu instalador de projeto. Se RunInstallerAttribute for false, a utilidade de instalação ignora o instalador do projeto.

Para uma instância de ServiceProcessInstaller, as propriedades que pode modificar incluem especificar que uma aplicação de serviço está a correr sob uma conta diferente do utilizador iniciado sessão. Pode especificar um par Password e par específicos Username sob os quais o serviço deve funcionar, ou pode usar Account para especificar que o serviço corra sob a conta de Sistema do computador, uma conta de serviço local ou de rede, ou uma conta de utilizador.

Normalmente, não chamas os métodos no ServiceInstaller teu código; geralmente são chamados apenas pela utilidade de instalação. A ferramenta de instalação chama automaticamente os ServiceProcessInstaller.Install métodos e ServiceInstaller.Install durante o processo de instalação. Compensa falhas, se necessário, ao chamar Rollback (ou ServiceInstaller.Rollback) todos os componentes previamente instalados.

A rotina de instalação de uma aplicação mantém automaticamente informações sobre os componentes já instalados, usando o arquivo do Installer.Contextinstalador do projeto Esta informação de estado é continuamente atualizada à medida que a ServiceProcessInstaller instância e cada ServiceInstaller instância é instalada pela utilidade. Normalmente não é necessário que o seu código modifique explicitamente esta informação de estado.

Instanciar a ServiceProcessInstaller faz com que o construtor de classe base, ComponentInstaller, seja chamado.

Ver também

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