ServiceProcessInstaller Třída

Definice

Obor názvů:: System.ServiceProcess

Sestavení:: System.ServiceProcess.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Nainstaluje spustitelný soubor obsahující třídy, které rozšiřují ServiceBase. Tato třída je volána instalačními nástroji, například InstallUtil.exe, při instalaci aplikace služby.

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 aHello-World Service 2. V konstruktoru pro MyProjectInstaller (který by byl volána instalačním nástrojem), ServiceInstaller objekty jsou vytvořeny pro každou službu a je ServiceProcessInstaller vytvořen pro spustitelný soubor. Aby instalační nástroj rozpoznal MyProjectInstaller jako platný instalační program, RunInstallerAttribute je atribut nastaven na true.

Volitelné vlastnosti jsou nastaveny v instalačním programu procesu a instalační programy služby před tím, než se instalační programy přidají do Installers kolekce. Když instalační nástroj přistupuje k MyProjectInstaller, objekty přidané do Installers kolekce prostřednictvím volání InstallerCollection.Add budou nainstalovány zase. Během tohoto procesu instalační program udržuje informace o stavu, které indikují, které objekty byly nainstalovány, takže každý objekt je možné zálohovat v případě selhání instalace.

Za normálníchokolnostch Vytvoříte jej a přidáte RunInstallerAttribute, ale instalační nástroj ve skutečnosti volá, a proto 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é pro všechny služby ve spustitelném souboru. Instalační nástroj ho používá k zápisu hodnot registru přidružených ke službám, které chcete nainstalovat.

Chcete-li nainstalovat službu, vytvořte třídu instalačního programu projektu, která dědí z Installer, a nastavte na RunInstallerAttributetrue třídu . V rámci projektu vytvořte instanci jedné ServiceProcessInstaller instance na 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 hledá třídy v sestavení služby s nastavenou RunInstallerAttribute na true. Přidejte do sestavení služby třídy tak, že je přidáte do Installers kolekce přidružené k instalačnímu programu projektu. Pokud RunInstallerAttribute ano false, instalační nástroj ignoruje instalační program projektu.

U instance vlastnosti ServiceProcessInstaller, které můžete upravit, patří určení, že aplikace služby běží pod jiným účtem než přihlášený uživatel. Můžete zadat konkrétní Username a Password pár, pod kterým má služba běžet, nebo můžete určit Account , že služba běží pod systémovým účtem počítače, místním nebo síťovým účtem služby nebo uživatelským účtem.

Note

Systémový účet počítače není stejný jako účet správce.

Za normálních okolností nevoláte metody ServiceInstaller v kódu; obvykle jsou volána pouze instalačním nástrojem. Instalační nástroj během procesu instalace automaticky volá ServiceProcessInstaller.Install metody a ServiceInstaller.Install metody. V případě potřeby vrátí chyby 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í, protože ServiceProcessInstaller instance a každá ServiceInstaller instance je nainstalovaná nástrojem. Obvykle není nutné, aby kód explicitně upravil tyto informace o stavu.

ServiceProcessInstaller Vytvoření instance konstruktoru základní třídy , ComponentInstallerbude volána.

Konstruktory

Name	Description
ServiceProcessInstaller()	Vytvoří novou instanci ServiceProcessInstaller třídy.

Vlastnosti

Name	Description
Account	Získá nebo nastaví typ účtu, pod kterým se má tato aplikace služby spustit.
CanRaiseEvents	Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	Získá ten IContainer , který obsahuje Component. (Zděděno od Component)
Context	Získá nebo nastaví informace o aktuální instalaci. (Zděděno od Installer)
DesignMode	Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
HelpText	Získá text nápovědy zobrazený pro možnosti instalace služby.
Installers	Získá kolekci instalačních programů, které tento instalační program obsahuje. (Zděděno od Installer)
Parent	Získá nebo nastaví instalační program obsahující kolekci, do které tento instalační program patří. (Zděděno od Installer)
Password	Získá nebo nastaví heslo přidružené k uživatelskému účtu, pod kterým aplikace služby běží.
Site	Získá nebo nastaví ISite objektu Component. (Zděděno od Component)
Username	Získá nebo nastaví uživatelský účet, pod kterým bude aplikace služby spuštěna.

Metody

Name	Description
Commit(IDictionary)	Při přepsání v odvozené třídě dokončí instalaci transakce. (Zděděno od Installer)
CopyFromComponent(IComponent)	Implementuje metodu základní třídy CopyFromComponent(IComponent) bez ServiceProcessInstaller chování specifického pro třídu.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané Component a volitelně uvolní spravované prostředky. (Zděděno od Component)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Install(IDictionary)	Zapíše informace o aplikaci služby do registru. Tato metoda je určena k použití instalačními nástroji, které volají příslušné metody automaticky.
IsEquivalentInstaller(ComponentInstaller)	Určuje, zda zadaný instalační program nainstaluje stejný objekt jako tento instalační program. (Zděděno od ComponentInstaller)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnAfterInstall(IDictionary)	AfterInstall Vyvolá událost. (Zděděno od Installer)
OnAfterRollback(IDictionary)	AfterRollback Vyvolá událost. (Zděděno od Installer)
OnAfterUninstall(IDictionary)	AfterUninstall Vyvolá událost. (Zděděno od Installer)
OnBeforeInstall(IDictionary)	BeforeInstall Vyvolá událost. (Zděděno od Installer)
OnBeforeRollback(IDictionary)	BeforeRollback Vyvolá událost. (Zděděno od Installer)
OnBeforeUninstall(IDictionary)	BeforeUninstall Vyvolá událost. (Zděděno od Installer)
OnCommitted(IDictionary)	Committed Vyvolá událost. (Zděděno od Installer)
OnCommitting(IDictionary)	Committing Vyvolá událost. (Zděděno od Installer)
Rollback(IDictionary)	Vrátí zpět informace o aplikaci služby zapsané do registru podle postupu instalace. Tato metoda je určena k použití instalačními nástroji, které automaticky zpracovávají příslušné metody.
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)
Uninstall(IDictionary)	Při přepsání v odvozené třídě odebere instalaci. (Zděděno od Installer)

Událost

Name	Description
AfterInstall	Nastane po Install(IDictionary) spuštění metod všech instalačních programů ve Installers vlastnosti. (Zděděno od Installer)
AfterRollback	Nastane po instalaci všech instalačních programů ve Installers vlastnosti se vrátí zpět. (Zděděno od Installer)
AfterUninstall	Nastane po všech instalačních programech ve Installers vlastnosti provádět své operace odinstalace. (Zděděno od Installer)
BeforeInstall	Nastane před spuštěním Install(IDictionary) metody každého instalačního programu v kolekci instalačního programu. (Zděděno od Installer)
BeforeRollback	Nastane před vrácením instalačních programů ve Installers vlastnosti. (Zděděno od Installer)
BeforeUninstall	Nastane dříve, než instalační programy ve Installers vlastnosti provádějí své operace odinstalace. (Zděděno od Installer)
Committed	Nastane po potvrzení všech instalačních programů ve Installers vlastnosti jejich instalace. (Zděděno od Installer)
Committing	Nastane před instalačními programy ve Installers vlastnosti potvrdí jejich instalace. (Zděděno od Installer)
Disposed	Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?