ServiceInstaller Klasse

Definition

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

Vererbung

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceInstaller

Beispiele

Im folgenden Beispiel wird ein Projektinstallationsprogramm erstellt, das aufgerufen MyProjectInstallerwird und von Installerdem geerbt wird. Es wird davon ausgegangen, dass es eine ausführbare Dienstdatei mit zwei Diensten "Hello-World Service 1" und "Hello-World Service 2" enthält. Innerhalb des Konstruktors für MyProjectInstaller (der vom Installationshilfsprogramm aufgerufen wird), ServiceInstaller werden Objekte für jeden dieser Dienste erstellt und eine ServiceProcessInstaller für die ausführbare Datei erstellt. Damit das Installationshilfsprogramm als gültiges Installationsprogramm erkannt MyProjectInstaller werden kann, wird das RunInstallerAttribute Attribut auf .true

Optionale Eigenschaften werden für das Prozessinstallationsprogramm und die Dienstinstallationsprogramme festgelegt, bevor die Installationsprogramme der Installers Auflistung hinzugefügt werden. Wenn das Installationshilfsprogramm auf sie zugreift MyProjectInstaller, werden die Objekte, die Installers der Auflistung über einen Aufruf InstallerCollection.Add hinzugefügt wurden, wiederum installiert. Während des Vorgangs verwaltet das Installationsprogramm Zustandsinformationen, die angeben, welche Objekte installiert wurden, sodass jedes wiederum gesichert werden kann, wenn ein Installationsfehler auftritt.

Normalerweise erstellen Sie keine Instanz der Projektinstallationsklasse explizit. Sie würden es erstellen und das RunInstallerAttribute Attribut der Syntax hinzufügen, aber es ist das Installationshilfsprogramm, das tatsächlich aufruft und daher die Klasse instanziiert.

#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

Hinweise

Dies ServiceInstaller funktioniert spezifisch für den Dienst, dem sie zugeordnet ist. Es wird vom Installationshilfsprogramm verwendet, um Registrierungswerte zu schreiben, die dem Dienst zugeordnet sind, in einen Unterschlüssel im HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services Registrierungsschlüssel. Der Dienst wird innerhalb dieses Unterschlüssels durch seinen ServiceName identifiziert. Der Unterschlüssel enthält auch den Namen der ausführbaren Datei oder .dll, zu der der Dienst gehört.

Um einen Dienst zu installieren, erstellen Sie eine Projektinstallationsprogrammklasse, die von der Installer Klasse erbt, und legen Sie das RunInstallerAttribute Attribut für die Klasse auf true. Erstellen Sie in Ihrem Projekt eine ServiceProcessInstaller Instanz pro Dienstanwendung und eine ServiceInstaller Instanz für jeden Dienst in der Anwendung. Legen Sie in Ihrem Project Installer-Klassenkonstruktor die Installationseigenschaften für den Dienst mithilfe der ServiceProcessInstaller Und ServiceInstaller Instanzen fest, und fügen Sie die Instanzen der Installers Auflistung hinzu.

Für alle Klassen, die von der Installer Klasse abgeleitet werden, muss der Status der Installers Auflistung in den Install und Uninstall den Methoden identisch sein. Sie können jedoch die Wartung der Auflistung über die Install verschiedenen Methoden Uninstall hinweg vermeiden, wenn Sie der Installers Auflistung im Konstruktor der benutzerdefinierten Installer-Klasse Instanzen hinzufügen. Wenn das Installationshilfsprogramm aufgerufen wird, wird nach dem RunInstallerAttribute Attribut gesucht. Wenn das Attribut lautet true, installiert das Hilfsprogramm alle Dienste, die der Installers Auflistung hinzugefügt wurden, die ihrem Projektinstallationsprogramm zugeordnet wurden. Wenn RunInstallerAttribute vorhanden oder false nicht vorhanden, ignoriert das Installationsprogramm das Projektinstallationsprogramm.

Die ServiceProcessInstaller zugeordnete Projektinstallationsklasse installiert Informationen, die allen ServiceInstaller Instanzen im Projekt gemeinsam sind. Wenn dieser Dienst etwas aufweist, das ihn von den anderen Diensten im Installationsprojekt trennt, werden diese dienstspezifischen Informationen von dieser Methode installiert.

Sie können andere Eigenschaften ServiceInstaller vor oder nach dem Hinzufügen Installers zur Auflistung des Projektinstallationsprogramms ändern. Beispielsweise kann ein Dienst StartType so festgelegt sein, dass der Dienst automatisch beim Neustart gestartet wird, oder ein Benutzer muss den Dienst manuell starten.

Normalerweise rufen Sie die Methoden ServiceInstaller in Ihrem Code nicht auf. Sie werden in der Regel nur vom Installationshilfsprogramm aufgerufen. Das Installationshilfsprogramm ruft die ServiceProcessInstaller.Install und ServiceInstaller.Install methoden während des Installationsvorgangs automatisch auf. Bei Bedarf werden Fehler durch Aufrufen Rollback (oder ServiceInstaller.Rollback) für alle zuvor installierten Komponenten zurückgesetzt.

Das Installationshilfsprogramm ruft auf Uninstall , um das Objekt zu entfernen.

Die Installationsroutine einer Anwendung verwaltet automatisch Informationen zu den bereits installierten Komponenten mithilfe des Projektinstallationsprogramms Installer.Context. Diese Statusinformationen werden kontinuierlich als ServiceProcessInstaller Instanz aktualisiert, und jede ServiceInstaller Instanz wird vom Hilfsprogramm installiert. Normalerweise ist es nicht erforderlich, dass Ihr Code Zustandsinformationen explizit ändert.

Wenn die Installation ausgeführt wird, wird automatisch eine EventLogInstaller Zum Installieren der Ereignisprotokollquelle erstellt, die der ServiceBase abgeleiteten Klasse zugeordnet ist. Die Log Eigenschaft für diese Quelle wird vom ServiceInstaller Konstruktor auf das Anwendungsprotokoll des Computers festgelegt. Wenn Sie den ServiceName Wert des ServiceInstaller (der mit dem ServiceBase.ServiceName Dienst identisch sein soll) festlegen, wird der Source Wert automatisch auf denselben Wert festgelegt. Bei einem Installationsfehler wird die Installation der Quelle zusammen mit zuvor installierten Diensten zurückgesetzt.

Die Uninstall Methode versucht, den Dienst zu beenden, wenn er ausgeführt wird. Unabhängig davon, ob dies erfolgreich ist, Uninstall werden die von ihnen vorgenommenen Änderungen rückgängig gemacht Install. Wenn eine neue Quelle für die Ereignisprotokollierung erstellt wurde, wird die Quelle gelöscht.

Weitere Informationen

• ServiceName
• ServiceProcessInstaller
• ServiceBase
• EventLog