ServiceProcessInstaller Klass

Definition

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

Arv

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

Exempel

I följande exempel skapas ett projektinstallationsprogram med namnet MyProjectInstaller, som ärver från Installer. Det antas att det finns en körbar tjänst som innehåller två tjänster, "Hello-World Service 1" och "Hello-World Service 2". I konstruktorn för MyProjectInstaller (som anropas av installationsverktyget) ServiceInstaller skapas objekt för varje tjänst och en ServiceProcessInstaller skapas för den körbara filen. För att installationsverktyget ska känna igen MyProjectInstaller som ett giltigt installationsprogram RunInstallerAttribute är attributet inställt på true.

Valfria egenskaper anges i processinstallationsprogrammet och tjänstinstallationsprogrammet innan installationsprogrammet läggs till i Installers samlingen. När installationsverktyget kommer åt MyProjectInstaller installeras objekten som läggs till Installers i samlingen via ett anrop till InstallerCollection.Add i tur och ordning. Under processen behåller installationsprogrammet tillståndsinformation som anger vilka objekt som har installerats, så att varje objekt kan säkerhetskopieras i tur och ordning i händelse av ett installationsfel.

Normalt instansierar du inte projektinstallationsklassen explicit. Du skulle skapa den och lägga till RunInstallerAttribute, men installationsverktyget anropar faktiskt, och därmed instansierar, klassen.

#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

Kommentarer

ServiceProcessInstaller Fungerar gemensamt för alla tjänster i en körbar fil. Det används av installationsverktyget för att skriva registervärden som är associerade med tjänster som du vill installera.

Om du vill installera en tjänst skapar du en projektinstallationsklass som ärver från Installeroch ställer in RunInstallerAttribute klassen på true. I projektet instansierar du en ServiceProcessInstaller instans per tjänstprogram och en ServiceInstaller instans för varje tjänst i programmet. Lägg slutligen till instansen ServiceProcessInstaller och instanserna i ServiceInstaller projektinstallationsklassen.

När InstallUtil.exe körs söker verktyget efter klasser i tjänstsammansättningen med RunInstallerAttribute värdet true. Lägg till klasser i tjänstsammansättningen genom att lägga till dem i samlingen som Installers är associerad med projektinstallationsprogrammet. Om RunInstallerAttribute är falseignorerar installationsverktyget projektinstallationsprogrammet.

För en instans av ServiceProcessInstaller, kan du ändra bland annat att ange att ett tjänstprogram ska köras under ett annat konto än den inloggade användaren. Du kan ange ett visst Username par under Password vilket tjänsten ska köras, eller så kan du använda Account för att ange att tjänsten ska köras under datorns systemkonto, ett lokalt konto eller ett nätverkstjänstkonto eller ett användarkonto.

Normalt anropar du inte metoderna i ServiceInstaller koden. De anropas vanligtvis endast av installationsverktyget. Installationsverktyget anropar ServiceProcessInstaller.Install automatiskt metoderna och ServiceInstaller.Install under installationsprocessen. Om det behövs säkerhetskopieras fel genom att anropa Rollback (eller ServiceInstaller.Rollback) på alla tidigare installerade komponenter.

Programmets installationsrutin lagrar automatiskt information om de komponenter som redan har installerats med hjälp av projektinstallationsprogrammets Installer.Context. Den här tillståndsinformationen uppdateras kontinuerligt när instansen ServiceProcessInstaller och varje ServiceInstaller instans installeras av verktyget. Det är vanligtvis inte nödvändigt för koden att uttryckligen ändra den här tillståndsinformationen.

Instansiering av en ServiceProcessInstaller gör att basklasskonstruktorn, ComponentInstaller, anropas.

Se även

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