ServiceProcessInstaller Classe

Définition

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

Héritage

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

Exemples

L’exemple suivant crée un programme d’installation de projet appelé MyProjectInstaller, qui hérite de Installer. Il est supposé qu’il existe un exécutable de service qui contient deux services , «Hello-World Service 1 » et «Hello-World Service 2 ». Dans le constructeur de MyProjectInstaller (qui serait appelé par l’utilitaire d’installation), ServiceInstaller les objets sont créés pour chaque service et un ServiceProcessInstaller objet est créé pour l’exécutable. Pour que l’utilitaire d’installation reconnaisse MyProjectInstaller comme programme d’installation valide, l’attribut RunInstallerAttribute est défini sur true.

Les propriétés facultatives sont définies sur le programme d’installation du processus et les programmes d’installation de service avant l’ajout des programmes d’installation à la Installers collection. Lorsque l’utilitaire d’installation accède à MyProjectInstaller, les objets ajoutés à la Installers collection via un appel à seront installés à InstallerCollection.Add leur tour. Pendant le processus, le programme d’installation conserve les informations d’état indiquant quels objets ont été installés, afin que chaque objet puisse être sauvegardé à son tour en cas d’échec d’installation.

Normalement, vous n’instanciez pas explicitement votre classe d’installation de projet. Vous le créez et ajoutez le RunInstallerAttribute, mais l’utilitaire d’installation appelle réellement, et instancie donc, la 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

Remarques

Le ServiceProcessInstaller travail est commun à tous les services d’un exécutable. Il est utilisé par l’utilitaire d’installation pour écrire des valeurs de Registre associées aux services que vous souhaitez installer.

Pour installer un service, créez une classe d’installation de projet qui hérite de Installer, puis définissez la RunInstallerAttribute classe truesur . Dans votre projet, instanciez une ServiceProcessInstaller instance par application de service et une ServiceInstaller instance pour chaque service de l’application. Enfin, ajoutez l’instance ServiceProcessInstaller et les ServiceInstaller instances à votre classe d’installation de projet.

Lorsque InstallUtil.exe s’exécute, l’utilitaire recherche des classes dans l’assembly de service avec la RunInstallerAttribute valeur définie truesur . Ajoutez des classes à l’assembly de service en les ajoutant à la Installers collection associée à votre programme d’installation de projet. Si RunInstallerAttribute c’est falsele cas, l’utilitaire d’installation ignore le programme d’installation du projet.

Pour une instance de ServiceProcessInstaller, les propriétés que vous pouvez modifier incluent la spécification qu’une application de service s’exécute sous un compte autre que l’utilisateur connecté. Vous pouvez spécifier une paire particulière UsernamePassword sous laquelle le service doit s’exécuter, ou vous pouvez l’utiliser Account pour spécifier que le service s’exécute sous le compte système de l’ordinateur, un compte de service local ou réseau ou un compte d’utilisateur.

Normalement, vous n’appelez pas les méthodes dans ServiceInstaller votre code ; elles sont généralement appelées uniquement par l’utilitaire d’installation. L’utilitaire d’installation appelle automatiquement les méthodes et ServiceProcessInstaller.Install les ServiceInstaller.Install méthodes pendant le processus d’installation. Elle sauvegarde les défaillances, si nécessaire, en appelant Rollback (ou ServiceInstaller.Rollback) sur tous les composants précédemment installés.

La routine d’installation d’une application gère automatiquement les informations sur les composants déjà installés, à l’aide du programme d’installation du Installer.Contextprojet. Ces informations d’état sont mises à jour en permanence à mesure que l’instance ServiceProcessInstaller et chaque ServiceInstaller instance est installée par l’utilitaire. Il est généralement inutile que votre code modifie explicitement ces informations d’état.

L’instanciation d’un ServiceProcessInstaller constructeur de classe de base est ComponentInstallerappelée.

Voir aussi

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