ServiceProcessInstaller Třída

Definice

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

Dědičnost

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

Příklady

Následující příklad vytvoří instalační program projektu s názvem MyProjectInstaller, který dědí z Installer. Předpokládá se, že existuje spustitelný soubor služby, který obsahuje dvě služby: "Hello-World Service 1" a "Hello-World Service 2". V konstruktoru pro MyProjectInstaller (který by byl volána instalačním nástrojem) ServiceInstaller jsou vytvořeny objekty pro každou službu a ServiceProcessInstaller je vytvořen pro spustitelný soubor. Aby instalační nástroj rozpoznal MyProjectInstaller jako platný instalační program, RunInstallerAttribute je atribut nastaven na truehodnotu .

Volitelné vlastnosti jsou nastaveny v instalačním programu procesu a instalačních programů služby před jejich přidání do Installers kolekce. Když instalační nástroj přistupuje k MyProjectInstaller, objekty přidané do Installers kolekce prostřednictvím volání se InstallerCollection.Add nainstalují. Během procesu instalační program udržuje informace o stavu, které označují, které objekty byly nainstalovány, takže každý objekt může být v případě selhání instalace zálohován.

Za normálních okolností byste explicitně nevytvořeli instanci třídy instalačního programu projektu. Vytvoříte ho a přidáte RunInstallerAttribute, ale instalační nástroj ve skutečnosti volá a vytvoří instanci třídy .

#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

Poznámky

Funguje ServiceProcessInstaller společně se všemi službami ve spustitelném souboru. Je používán instalačním nástrojem k zápisu hodnot registru přidružených ke službám, které chcete nainstalovat.

Pokud chcete nainstalovat službu, vytvořte třídu instalačního programu projektu, která dědí z Installer, a nastavte RunInstallerAttribute třídu pro třídu na true. V rámci projektu vytvořte instanci jedné ServiceProcessInstaller instance pro každou aplikaci služby a jednu ServiceInstaller instanci pro každou službu v aplikaci. Nakonec přidejte ServiceProcessInstaller instanci a ServiceInstaller instance do třídy instalačního programu projektu.

Při spuštění InstallUtil.exe nástroj vyhledá třídy v sestavení služby s nastavenou RunInstallerAttribute na true. Přidejte třídy do sestavení služby tak, že je přidáte do Installers kolekce přidružené k instalačnímu programu projektu. Pokud RunInstallerAttribute je false, instalační nástroj ignoruje instalační program projektu.

U instance ServiceProcessInstallermůžete upravit vlastnosti, mezi které patří určení, že aplikace služby běží pod jiným účtem, než je přihlášený uživatel. Můžete zadat konkrétní Username a Password pár, ve kterém má služba běžet, nebo můžete použít Account k určení, že se služba spouští pod účtem Systému počítače, místním nebo síťovým účtem služby nebo uživatelským účtem.

Za normálních okolností nevoláte metody na ServiceInstaller v rámci kódu; jsou obecně volána pouze instalačním nástrojem. Instalační nástroj během procesu instalace automaticky volá ServiceProcessInstaller.Install metody a ServiceInstaller.Install . V případě potřeby zatěžuje selhání voláním Rollback (nebo ServiceInstaller.Rollback) u všech dříve nainstalovaných komponent.

Instalační rutina aplikace udržuje informace o již nainstalovaných komponentách automaticky pomocí instalačního Installer.Contextprogramu projektu . Tyto informace o stavu se průběžně aktualizují ServiceProcessInstaller jako instance a každá ServiceInstaller instance je nainstalována nástrojem . Obvykle není nutné, aby kód tyto informace o stavu upravl explicitně.

Vytvoření instance ServiceProcessInstaller způsobí zavolání ComponentInstallerkonstruktoru základní třídy .

Konstruktory

Vlastnosti

Metody

Událost

Platí pro

Viz také

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