ServiceProcessInstaller Klas

Definitie

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

Overname

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

Voorbeelden

In het volgende voorbeeld wordt een projectinstallatieprogramma gemaakt met de naam MyProjectInstaller, dat wordt overgenomen van Installer. Er wordt ervan uitgegaan dat er een uitvoerbaar servicebestand is dat twee services bevat: 'Hello-World Service 1' en 'Hello-World Service 2'. In de constructor voor MyProjectInstaller (die door het installatieprogramma wordt aangeroepen), ServiceInstaller worden objecten gemaakt voor elke service en wordt er een ServiceProcessInstaller gemaakt voor het uitvoerbare bestand. Voor het installatieprogramma om MyProjectInstaller te herkennen als een geldig installatieprogramma, is het RunInstallerAttribute kenmerk ingesteld op true.

Optionele eigenschappen worden ingesteld voor het procesinstallatieprogramma en de serviceinstallatieprogramma's voordat de installatieprogramma's aan de Installers verzameling worden toegevoegd. Wanneer het installatieprogramma Toegang krijgt tot MyProjectInstaller, worden de objecten die via een aanroep aan InstallerCollection.Add de verzameling worden toegevoegdInstallers, weer geïnstalleerd. Tijdens het proces onderhoudt het installatieprogramma statusinformatie die aangeeft welke objecten zijn geïnstalleerd, zodat elk object op zijn beurt kan worden ondersteund in het geval van een installatiefout.

Normaal gesproken zou u uw projectinstallatieklasse niet expliciet instantiëren. U maakt het en voegt het RunInstallerAttributetoe, maar het installatieprogramma roept daadwerkelijk aan en maakt daarom een instantie van de klasse.

#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

Opmerkingen

Dit ServiceProcessInstaller werkt gebruikelijk voor alle services in een uitvoerbaar bestand. Het wordt gebruikt door het installatieprogramma om registerwaarden te schrijven die zijn gekoppeld aan services die u wilt installeren.

Als u een service wilt installeren, maakt u een klasse voor projectinstallatieprogramma's van Installeren stelt u de RunInstallerAttribute klasse truein op . Binnen uw project instantieert u één ServiceProcessInstaller exemplaar per servicetoepassing en één ServiceInstaller exemplaar voor elke service in de toepassing. Voeg ten slotte het ServiceProcessInstaller exemplaar en de ServiceInstaller exemplaren toe aan de klasse van uw projectinstallatieprogramma.

Wanneer InstallUtil.exe wordt uitgevoerd, zoekt het hulpprogramma naar klassen in de serviceassembly met de RunInstallerAttribute set op true. Voeg klassen toe aan de serviceassembly door ze toe te voegen aan de Installers verzameling die is gekoppeld aan uw projectinstallatieprogramma. Als RunInstallerAttribute dat het is false, negeert het installatieprogramma van het project.

Voor een exemplaar van ServiceProcessInstaller, eigenschappen die u kunt wijzigen, omvatten het opgeven dat een servicetoepassing wordt uitgevoerd onder een ander account dan de aangemelde gebruiker. U kunt een bepaald Username en Password paar opgeven waaronder de service moet worden uitgevoerd, of u kunt gebruiken Account om op te geven dat de service wordt uitgevoerd onder het systeemaccount van de computer, een lokaal of netwerkserviceaccount of een gebruikersaccount.

Normaal gesproken roept u de methoden in uw code niet aan ServiceInstaller ; ze worden meestal alleen aangeroepen door het installatieprogramma. Het installatieprogramma roept ServiceProcessInstaller.Install de en ServiceInstaller.Install methoden automatisch aan tijdens het installatieproces. Er worden, indien nodig, fouten geretourneerd door alle eerder geïnstalleerde onderdelen aan te roepen Rollback (of ServiceInstaller.Rollback) .

De installatieroutine van een toepassing onderhoudt automatisch informatie over de onderdelen die al zijn geïnstalleerd, met behulp van de installatieprogramma's van Installer.Contexthet project. Deze statusinformatie wordt continu bijgewerkt wanneer het ServiceProcessInstaller exemplaar en elk ServiceInstaller exemplaar wordt geïnstalleerd door het hulpprogramma. Het is meestal niet nodig dat uw code deze statusinformatie expliciet wijzigt.

Als u een ServiceProcessInstaller instantie maakt, wordt de basisklasseconstructor aangeroepen ComponentInstaller.

Zie ook

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