ServiceInstaller Classe

Definição

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

public class ServiceInstaller : System.Configuration.Install.ComponentInstaller

type ServiceInstaller = class
    inherit ComponentInstaller

Public Class ServiceInstaller
Inherits ComponentInstaller

Herança

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceInstaller

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 um desses serviços e um ServiceProcessInstaller é criado para o executável. Para o utilitário de instalação reconhecer 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 for acessado 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, para que cada um possa ser retirado, por sua vez, se ocorrer uma falha de instalação.

Normalmente, você não criaria uma instância da classe do instalador de projeto explicitamente. Você o criaria e adicionaria o RunInstallerAttribute atributo à sintaxe, mas é o utilitário de instalação que 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 ServiceInstaller trabalho funciona específico ao serviço ao qual ele está associado. Ele é usado pelo utilitário de instalação para gravar valores de registro associados ao serviço em uma subchave dentro da chave do registro HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services. O serviço é identificado por seu ServiceName nessa subchave. A subchave também inclui o nome do executável ou .dll ao qual o serviço pertence.

Para instalar um serviço, crie uma classe de instalador de projeto que herda da Installer classe e defina o RunInstallerAttribute atributo na classe como true. Em seu projeto, crie uma ServiceProcessInstaller instância por aplicativo de serviço e uma ServiceInstaller instância para cada serviço no aplicativo. No construtor da classe do instalador de projeto, defina as propriedades de instalação do serviço usando as ServiceProcessInstaller instâncias e ServiceInstaller as instâncias e adicione as instâncias à Installers coleção.

Para todas as classes derivadas da Installer classe, o estado da Installers coleção deve ser o mesmo nos métodos e Uninstall nos Install métodos. No entanto, você pode evitar a manutenção da coleção entre os Install métodos e Uninstall se adicionar instâncias do Installers instalador à coleção no construtor de classe do instalador personalizado. Quando o utilitário de instalação é chamado, ele procura o RunInstallerAttribute atributo. Se o atributo for true, o utilitário instalará todos os serviços que foram adicionados à Installers coleção associada ao instalador do projeto. Se RunInstallerAttribute existir false ou não, o utilitário de instalação ignorará o instalador do projeto.

A ServiceProcessInstaller classe de instalação associada ao projeto instala informações comuns a todas as ServiceInstaller instâncias do projeto. Se esse serviço tiver algo que o separe dos outros serviços no projeto de instalação, essas informações específicas do serviço serão instaladas por esse método.

Você pode modificar outras propriedades no ServiceInstaller antes ou depois de adicioná-las à Installers coleção do instalador do projeto. Por exemplo, um serviço StartType pode ser definido para iniciar o serviço automaticamente na reinicialização ou exigir que um usuário inicie o serviço manualmente.

Normalmente, você não chamará 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 ServiceInstaller.Install os ServiceProcessInstaller.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.

O utilitário de instalação chama Uninstall para remover o objeto.

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 como a ServiceProcessInstaller instância e cada ServiceInstaller instância é instalada pelo utilitário. Geralmente, é desnecessário que seu código modifique explicitamente as informações de estado.

Quando a instalação é executada, ela cria automaticamente uma EventLogInstaller fonte de log de eventos associada à ServiceBase classe derivada. A Log propriedade dessa origem é definida pelo ServiceInstaller construtor para o log de aplicativos do computador. Quando você define o ServiceName ( ServiceInstaller que deve ser idêntico ao ServiceBase.ServiceName do serviço), ele Source é automaticamente definido como o mesmo valor. Em uma falha de instalação, a instalação da origem é revertida juntamente com os serviços instalados anteriormente.

O Uninstall método tentará interromper o serviço se ele estiver em execução. Se isso for bem-sucedido ou não, Uninstall desfaça as alterações feitas por Install. Se uma nova fonte tiver sido criada para o registro em log de eventos, a origem será excluída.

Confira também

• ServiceName
• ServiceProcessInstaller
• ServiceBase
• EventLog