ServiceProcessInstaller Klasa

Definicja

Instaluje plik wykonywalny zawierający klasy, które są rozszerzone ServiceBase .Installs an executable containing classes that extend ServiceBase. Ta klasa jest wywoływana przez narzędzia instalacyjne, takie jak InstallUtil.exe, podczas instalowania aplikacji usługi.This class is called by installation utilities, such as InstallUtil.exe, when installing a service application.

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
Dziedziczenie

Przykłady

Poniższy przykład tworzy Instalatora projektu o nazwie MyProjectInstaller, który dziedziczy z Installer .The following example creates a project installer called MyProjectInstaller, which inherits from Installer. Przyjęto założenie, że jest to plik wykonywalny usługi, który zawiera dwie usługi "Hello-World Service 1" i "Hello-World Service 2".It is assumed there is a service executable that contains two services, "Hello-World Service 1" and "Hello-World Service 2". W konstruktorze dla MyProjectInstaller (który zostałby wywołany przez narzędzie instalacji), ServiceInstaller obiekty są tworzone dla każdej usługi i ServiceProcessInstaller zostanie utworzony dla pliku wykonywalnego.Within the constructor for MyProjectInstaller (which would be called by the install utility), ServiceInstaller objects are created for each service, and a ServiceProcessInstaller is created for the executable. Aby narzędzie instalacji rozpoznawał MyProjectInstaller jako prawidłowy Instalator, RunInstallerAttribute atrybut jest ustawiany na true .For the install utility to recognize MyProjectInstaller as a valid installer, the RunInstallerAttribute attribute is set to true.

Przed dodaniem Instalatora do kolekcji są ustawiane właściwości opcjonalne w instalatorze procesu i na instalacjach usługi Installers .Optional properties are set on the process installer and the service installers before the installers are added to the Installers collection. Gdy narzędzie instalacji uzyskuje dostęp do MyProjectInstaller, obiekty dodawane do Installers kolekcji za pomocą wywołania do InstallerCollection.Add zostaną zainstalowane z kolei.When the install utility accesses MyProjectInstaller, the objects added to the Installers collection through a call to InstallerCollection.Add will be installed in turn. W trakcie tego procesu Instalator przechowuje informacje o stanie wskazujące, które obiekty zostały zainstalowane, więc można utworzyć kopię zapasową każdego obiektu z kolei w przypadku niepowodzenia instalacji.During the process, the installer maintains state information indicating which objects have been installed, so each object can be backed out in turn in case of an installation failure.

Zwykle nie można jawnie utworzyć wystąpienia klasy Instalatora projektu.Normally, you would not instantiate your project installer class explicitly. Należy go utworzyć i dodać RunInstallerAttribute , ale narzędzie instalacji rzeczywiście wywołuje i w związku z tym tworzy wystąpienie klasy.You would create it and add the RunInstallerAttribute, but the install utility actually calls, and therefore instantiates, the class.

#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

Uwagi

ServiceProcessInstallerDziała dla wszystkich usług w pliku wykonywalnym.The ServiceProcessInstaller does work common to all services in an executable. Jest on używany przez narzędzie instalacji do zapisywania wartości rejestru skojarzonych z usługami, które chcesz zainstalować.It is used by the installation utility to write registry values associated with services you want to install.

Aby zainstalować usługę, należy utworzyć klasę Instalatora projektu, która dziedziczy po Installer , i ustawić RunInstallerAttribute klasy na true .To install a service, create a project installer class that inherits from Installer, and set the RunInstallerAttribute on the class to true. W projekcie Utwórz wystąpienie jednego ServiceProcessInstaller wystąpienia na aplikację usługi i jedno ServiceInstaller wystąpienie dla każdej usługi w aplikacji.Within your project, instantiate one ServiceProcessInstaller instance per service application, and one ServiceInstaller instance for each service in the application. Na koniec Dodaj ServiceProcessInstaller wystąpienie i ServiceInstaller wystąpienia do klasy Instalatora projektu.Finally, add the ServiceProcessInstaller instance and the ServiceInstaller instances to your project installer class.

Po uruchomieniu InstallUtil.exe narzędzie szuka klas w zestawie usług z RunInstallerAttribute ustawionym na true .When InstallUtil.exe runs, the utility looks for classes in the service assembly with the RunInstallerAttribute set to true. Dodaj klasy do zestawu usług, dodając je do Installers kolekcji skojarzonej z instalatorem projektu.Add classes to the service assembly by adding them to the Installers collection associated with your project installer. Jeśli RunInstallerAttribute jest false , narzędzie instalacji ignoruje Instalatora projektu.If RunInstallerAttribute is false, the install utility ignores the project installer.

W przypadku wystąpienia elementu ServiceProcessInstaller właściwości można modyfikować obejmują określenie, że aplikacja usługi jest uruchamiana w ramach konta innego niż zalogowany użytkownik.For an instance of ServiceProcessInstaller, properties you can modify include specifying that a service application run under an account other than the logged-on user. Możesz określić konkretną Username i Password parę, w której ma zostać uruchomiona usługa, lub użyć, Account Aby określić, że usługa jest uruchamiana na koncie systemowym komputera, na koncie usługi lokalnej lub w sieci lub na koncie użytkownika.You can specify a particular Username and Password pair under which the service should run, or you can use Account to specify that the service run under the computer's System account, a local or network service account, or a user account.

Uwaga

Konto systemowe komputera nie jest takie samo jak konto administratora.The computer's System account is not the same as the Administrator account.

Zwykle nie są wywoływane metody w ServiceInstaller kodzie; są one zwykle wywoływane tylko przez narzędzie instalacji.Normally, you do not call the methods on ServiceInstaller within your code; they are generally called only by the install utility. Narzędzie instalacji automatycznie wywołuje ServiceProcessInstaller.Install metody i w ServiceInstaller.Install trakcie procesu instalacji.The install utility automatically calls the ServiceProcessInstaller.Install and ServiceInstaller.Install methods during the installation process. W razie potrzeby wykonuje kopię zapasową błędów, wywołując Rollback (lub ServiceInstaller.Rollback ) na wszystkich wcześniej zainstalowanych składnikach.It backs out failures, if necessary, by calling Rollback (or ServiceInstaller.Rollback) on all previously installed components.

Procedura instalacji aplikacji zachowuje automatycznie informacje o składnikach, które są już zainstalowane, przy użyciu Instalatora projektu Installer.Context .An application's install routine maintains information automatically about the components already installed, using the project installer's Installer.Context. Informacje o stanie są stale aktualizowane jako ServiceProcessInstaller wystąpienie i każde ServiceInstaller wystąpienie jest instalowane przez narzędzie.This state information is continuously updated as the ServiceProcessInstaller instance and each ServiceInstaller instance is installed by the utility. Zwykle nie jest konieczne, aby kod mógł jawnie modyfikować te informacje o stanie.It is usually unnecessary for your code to modify this state information explicitly.

Utworzenie wystąpienia ServiceProcessInstaller powoduje, że Konstruktor klasy bazowej, ComponentInstaller ,, ma zostać wywołany.Instantiating a ServiceProcessInstaller causes the base class constructor, ComponentInstaller, to be called.

Konstruktory

ServiceProcessInstaller()

Tworzy nowe wystąpienie klasy ServiceProcessInstaller.Creates a new instance of the ServiceProcessInstaller class.

Właściwości

Account

Pobiera lub ustawia typ konta, pod którym zostanie uruchomiona ta aplikacja usługi.Gets or sets the type of account under which to run this service application.

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
Container

Pobiera IContainer , który zawiera Component .Gets the IContainer that contains the Component.

(Odziedziczone po Component)
Context

Pobiera lub ustawia informacje o bieżącej instalacji.Gets or sets information about the current installation.

(Odziedziczone po Installer)
DesignMode

Pobiera wartość wskazującą, czy Component jest aktualnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego elementu Component .Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
HelpText

Pobiera tekst pomocy dla opcji instalacji usługi.Gets help text displayed for service installation options.

Installers

Pobiera kolekcję instalatorów, które zawiera ten Instalator.Gets the collection of installers that this installer contains.

(Odziedziczone po Installer)
Parent

Pobiera lub ustawia Instalator zawierający kolekcję, do której należy ten Instalator.Gets or sets the installer containing the collection that this installer belongs to.

(Odziedziczone po Installer)
Password

Pobiera lub ustawia hasło skojarzone z kontem użytkownika, w którym jest uruchomiona aplikacja usługi.Gets or sets the password associated with the user account under which the service application runs.

Site

Pobiera lub ustawia wartość ISite Component .Gets or sets the ISite of the Component.

(Odziedziczone po Component)
Username

Pobiera lub ustawia konto użytkownika, pod którym zostanie uruchomiona aplikacja usługi.Gets or sets the user account under which the service application will run.

Metody

Commit(IDictionary)

Gdy jest zastępowany w klasie pochodnej, uzupełnia transakcja instalacji.When overridden in a derived class, completes the install transaction.

(Odziedziczone po Installer)
CopyFromComponent(IComponent)

Implementuje metodę klasy bazowej CopyFromComponent(IComponent) bez ServiceProcessInstaller zachowania związanego z klasą.Implements the base class CopyFromComponent(IComponent) method with no ServiceProcessInstaller class-specific behavior.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Odziedziczone po Component)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub przez Container .Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
Install(IDictionary)

Zapisuje informacje o aplikacji usługi w rejestrze.Writes service application information to the registry. Ta metoda jest przeznaczona do użycia przez narzędzia instalacyjne, które automatycznie wywołują odpowiednie metody.This method is meant to be used by installation tools, which call the appropriate methods automatically.

IsEquivalentInstaller(ComponentInstaller)

Określa, czy określony Instalator instaluje ten sam obiekt co ten Instalator.Determines if the specified installer installs the same object as this installer.

(Odziedziczone po ComponentInstaller)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
OnAfterInstall(IDictionary)

Podnosi AfterInstall zdarzenie.Raises the AfterInstall event.

(Odziedziczone po Installer)
OnAfterRollback(IDictionary)

Podnosi AfterRollback zdarzenie.Raises the AfterRollback event.

(Odziedziczone po Installer)
OnAfterUninstall(IDictionary)

Podnosi AfterUninstall zdarzenie.Raises the AfterUninstall event.

(Odziedziczone po Installer)
OnBeforeInstall(IDictionary)

Podnosi BeforeInstall zdarzenie.Raises the BeforeInstall event.

(Odziedziczone po Installer)
OnBeforeRollback(IDictionary)

Podnosi BeforeRollback zdarzenie.Raises the BeforeRollback event.

(Odziedziczone po Installer)
OnBeforeUninstall(IDictionary)

Podnosi BeforeUninstall zdarzenie.Raises the BeforeUninstall event.

(Odziedziczone po Installer)
OnCommitted(IDictionary)

Podnosi Committed zdarzenie.Raises the Committed event.

(Odziedziczone po Installer)
OnCommitting(IDictionary)

Podnosi Committing zdarzenie.Raises the Committing event.

(Odziedziczone po Installer)
Rollback(IDictionary)

Wycofuje informacje o aplikacji usługi zapisywane w rejestrze przez procedurę instalacji.Rolls back service application information written to the registry by the installation procedure. Ta metoda jest przeznaczona do użycia przez narzędzia instalacyjne, które automatycznie przetwarzają odpowiednie metody.This method is meant to be used by installation tools, which process the appropriate methods automatically.

ToString()

Zwraca wartość String zawierającą nazwę Component (jeśli istnieje).Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)
Uninstall(IDictionary)

Gdy jest zastępowany w klasie pochodnej, usuwa instalację.When overridden in a derived class, removes an installation.

(Odziedziczone po Installer)

Zdarzenia

AfterInstall

Występuje po Install(IDictionary) uruchomieniu metod wszystkich instalatorów we Installers właściwości.Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Odziedziczone po Installer)
AfterRollback

Występuje po wycofaniu instalacji wszystkich instalatorów we Installers właściwości.Occurs after the installations of all the installers in the Installers property are rolled back.

(Odziedziczone po Installer)
AfterUninstall

Występuje, gdy wszystkie Instalatory we Installers Właściwości wykonują operacje odinstalowywania.Occurs after all the installers in the Installers property perform their uninstallation operations.

(Odziedziczone po Installer)
BeforeInstall

Występuje przed Install(IDictionary) uruchomieniem metody każdego Instalatora w kolekcji Instalatora.Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Odziedziczone po Installer)
BeforeRollback

Występuje przed wycofaniem instalatorów we Installers właściwości.Occurs before the installers in the Installers property are rolled back.

(Odziedziczone po Installer)
BeforeUninstall

Występuje przed Installers wykonaniem operacji odinstalowywania przez instalatorów we właściwości.Occurs before the installers in the Installers property perform their uninstall operations.

(Odziedziczone po Installer)
Committed

Występuje po Installers pomyślnej instalacji wszystkich instalatorów we właściwości.Occurs after all the installers in the Installers property have committed their installations.

(Odziedziczone po Installer)
Committing

Występuje przed zatwierdzeniem instalacji przez instalatorów we Installers właściwości.Occurs before the installers in the Installers property commit their installations.

(Odziedziczone po Installer)
Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie Dispose() metody.Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)

Dotyczy

Zobacz też