ServiceProcessInstaller ServiceProcessInstaller ServiceProcessInstaller ServiceProcessInstaller Class

Definizione

Installa un eseguibile contenente le classi che estendono ServiceBase.Installs an executable containing classes that extend ServiceBase. Questa classe viene chiamata dalle utilità di installazione, quale InstallUtil.exe, durante l'installazione di un'applicazione di servizio.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
Ereditarietà

Esempi

Nell'esempio seguente viene creato un programma di installazione del progetto denominato MyProjectInstaller Installer, che eredita da.The following example creates a project installer called MyProjectInstaller, which inherits from Installer. Si presuppone che esista un eseguibile del servizio che contiene due servizi, "Hello-World Service 1" e "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". All'interno del costruttore di MyProjectInstaller (che verrebbe chiamato dall'utilità di installazione), ServiceInstaller gli oggetti vengono creati per ogni servizio e viene ServiceProcessInstaller creato un oggetto per il file eseguibile.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. Per fare in modo che l'utilità di installazione riconosca MyProjectInstaller come RunInstallerAttribute programma di installazione valido true, l'attributo è impostato su.For the install utility to recognize MyProjectInstaller as a valid installer, the RunInstallerAttribute attribute is set to true.

Le proprietà facoltative vengono impostate nel programma di installazione del processo e nei programmi di installazione del servizio prima che Installers i programmi di installazione vengano aggiunti alla raccolta.Optional properties are set on the process installer and the service installers before the installers are added to the Installers collection. Quando l'utilità di installazione accede a MyProjectInstaller, gli oggetti aggiunti alla Installers raccolta tramite una chiamata a InstallerCollection.Add verranno installati a sua volta.When the install utility accesses MyProjectInstaller, the objects added to the Installers collection through a call to InstallerCollection.Add will be installed in turn. Durante il processo, il programma di installazione mantiene le informazioni sullo stato che indicano quali oggetti sono stati installati, quindi è possibile eseguire il backup di ogni oggetto a turno in caso di errore di installazione.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.

In genere, non si crea un'istanza della classe del programma di installazione del progetto in modo esplicito.Normally, you would not instantiate your project installer class explicitly. È possibile crearla e aggiungere RunInstallerAttribute, ma l'utilità di installazione chiama effettivamente e pertanto crea un'istanza della classe.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

Commenti

Il ServiceProcessInstaller funziona in modo comune a tutti i servizi in un file eseguibile.The ServiceProcessInstaller does work common to all services in an executable. Viene utilizzato dall'utilità di installazione per scrivere i valori del registro di sistema associati ai servizi che si desidera installare.It is used by the installation utility to write registry values associated with services you want to install.

Per installare un servizio, creare una classe del programma di installazione del Installer RunInstallerAttribute progetto che erediti da e impostare sulla classe truesu.To install a service, create a project installer class that inherits from Installer, and set the RunInstallerAttribute on the class to true. All'interno del progetto, creare un' ServiceProcessInstaller istanza per ogni applicazione di servizio ServiceInstaller e un'istanza per ogni servizio nell'applicazione.Within your project, instantiate one ServiceProcessInstaller instance per service application, and one ServiceInstaller instance for each service in the application. Aggiungere infine l' ServiceProcessInstaller istanza e le ServiceInstaller istanze alla classe del programma di installazione del progetto.Finally, add the ServiceProcessInstaller instance and the ServiceInstaller instances to your project installer class.

Quando InstallUtil. exe viene eseguito, l'utilità cerca le classi nell'assembly del servizio con RunInstallerAttribute impostato su true.When InstallUtil.exe runs, the utility looks for classes in the service assembly with the RunInstallerAttribute set to true. Aggiungere classi all'assembly del servizio aggiungendole alla Installers raccolta associata al programma di installazione del progetto.Add classes to the service assembly by adding them to the Installers collection associated with your project installer. Se RunInstallerAttribute èfalse, l'utilità di installazione ignora il programma di installazione del progetto.If RunInstallerAttribute is false, the install utility ignores the project installer.

Per un'istanza di ServiceProcessInstaller, le proprietà che è possibile modificare includono specificare che un'applicazione di servizio viene eseguita con un account diverso dall'utente connesso.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. È possibile specificare una particolare Username e Password una coppia in cui deve essere eseguito il servizio oppure è possibile Account utilizzare per specificare che il servizio venga eseguito con l'account di sistema del computer, un account di servizio locale o di rete o un account utente.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.

Nota

L'account di sistema del computer non corrisponde a quello dell'account amministratore.The computer's System account is not the same as the Administrator account.

In genere, non si chiamano i metodi ServiceInstaller all'interno del codice, in genere vengono chiamati solo dall'utilità di installazione.Normally, you do not call the methods on ServiceInstaller within your code; they are generally called only by the install utility. L'utilità di installazione chiama automaticamente ServiceProcessInstaller.Install i ServiceInstaller.Install metodi e durante il processo di installazione.The install utility automatically calls the ServiceProcessInstaller.Install and ServiceInstaller.Install methods during the installation process. Se necessario, vengono restituiti errori chiamando Rollback (o ServiceInstaller.Rollback) su tutti i componenti installati in precedenza.It backs out failures, if necessary, by calling Rollback (or ServiceInstaller.Rollback) on all previously installed components.

La routine di installazione di un'applicazione mantiene automaticamente le informazioni sui componenti già installati, usando il programma Installer.Contextdi installazione del progetto.An application's install routine maintains information automatically about the components already installed, using the project installer's Installer.Context. Queste informazioni sullo stato vengono aggiornate continuamente come ServiceProcessInstaller l'istanza di ServiceInstaller e ogni istanza viene installata dall'utilità.This state information is continuously updated as the ServiceProcessInstaller instance and each ServiceInstaller instance is installed by the utility. In genere non è necessario che il codice modifichi queste informazioni sullo stato in modo esplicito.It is usually unnecessary for your code to modify this state information explicitly.

La creazione di ServiceProcessInstaller un'istanza di un oggetto determina ComponentInstallerla chiamata del costruttore della classe base,.Instantiating a ServiceProcessInstaller causes the base class constructor, ComponentInstaller, to be called.

Costruttori

ServiceProcessInstaller() ServiceProcessInstaller() ServiceProcessInstaller() ServiceProcessInstaller()

Crea una nuova istanza della classe ServiceProcessInstaller.Creates a new instance of the ServiceProcessInstaller class.

Proprietà

Account Account Account Account

Ottiene o imposta il tipo di account utente con cui eseguire l'applicazione del servizio.Gets or sets the type of account under which to run this service application.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Context Context Context Context

Ottiene o imposta le informazioni sull'installazione corrente.Gets or sets information about the current installation.

(Inherited from Installer)
DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
HelpText HelpText HelpText HelpText

Ottiene il testo della guida visualizzato per le opzioni di installazione del servizio.Gets help text displayed for service installation options.

Installers Installers Installers Installers

Ottiene l'insieme dei programmi di installazione contenuti nel programma.Gets the collection of installers that this installer contains.

(Inherited from Installer)
Parent Parent Parent Parent

Ottiene o imposta il programma di installazione contenente l'insieme cui appartiene questo programma di installazione.Gets or sets the installer containing the collection that this installer belongs to.

(Inherited from Installer)
Password Password Password Password

Ottiene o imposta la password associata all'account utente con cui sarà eseguita l'applicazione del servizio.Gets or sets the password associated with the user account under which the service application runs.

Site Site Site Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Username Username Username Username

Ottiene o imposta l'account utente con cui verrà eseguita l'applicazione del servizio.Gets or sets the user account under which the service application will run.

Metodi

Commit(IDictionary) Commit(IDictionary) Commit(IDictionary) Commit(IDictionary)

Quando sottoposto a override in una classe derivata, completa la transazione di installazione.When overridden in a derived class, completes the install transaction.

(Inherited from Installer)
CopyFromComponent(IComponent) CopyFromComponent(IComponent) CopyFromComponent(IComponent) CopyFromComponent(IComponent)

Implementa il metodo CopyFromComponent(IComponent) della classe base senza alcun funzionamento specifico della classe ServiceProcessInstaller.Implements the base class CopyFromComponent(IComponent) method with no ServiceProcessInstaller class-specific behavior.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Install(IDictionary) Install(IDictionary) Install(IDictionary) Install(IDictionary)

Scrive le informazioni sull'applicazione di servizio nel Registro di sistema.Writes service application information to the registry. È necessario che questo metodo venga utilizzato dagli strumenti di installazione che richiamano automaticamente i metodi corretti.This method is meant to be used by installation tools, which call the appropriate methods automatically.

IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller)

Determina se il programma di installazione specificato consente di installare lo stesso oggetto del programma di installazione corrente.Determines if the specified installer installs the same object as this installer.

(Inherited from ComponentInstaller)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnAfterInstall(IDictionary) OnAfterInstall(IDictionary) OnAfterInstall(IDictionary) OnAfterInstall(IDictionary)

Genera l'evento AfterInstall.Raises the AfterInstall event.

(Inherited from Installer)
OnAfterRollback(IDictionary) OnAfterRollback(IDictionary) OnAfterRollback(IDictionary) OnAfterRollback(IDictionary)

Genera l'evento AfterRollback.Raises the AfterRollback event.

(Inherited from Installer)
OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary)

Genera l'evento AfterUninstall.Raises the AfterUninstall event.

(Inherited from Installer)
OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary)

Genera l'evento BeforeInstall.Raises the BeforeInstall event.

(Inherited from Installer)
OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary)

Genera l'evento BeforeRollback.Raises the BeforeRollback event.

(Inherited from Installer)
OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary)

Genera l'evento BeforeUninstall.Raises the BeforeUninstall event.

(Inherited from Installer)
OnCommitted(IDictionary) OnCommitted(IDictionary) OnCommitted(IDictionary) OnCommitted(IDictionary)

Genera l'evento Committed.Raises the Committed event.

(Inherited from Installer)
OnCommitting(IDictionary) OnCommitting(IDictionary) OnCommitting(IDictionary) OnCommitting(IDictionary)

Genera l'evento Committing.Raises the Committing event.

(Inherited from Installer)
Rollback(IDictionary) Rollback(IDictionary) Rollback(IDictionary) Rollback(IDictionary)

Annulla le informazioni dell'applicazione di servizio scritte nel Registro di sistema dalla procedura di installazione.Rolls back service application information written to the registry by the installation procedure. È necessario che il metodo venga utilizzato dagli strumenti di installazione che elaborano automaticamente i metodi corretti.This method is meant to be used by installation tools, which process the appropriate methods automatically.

ToString() ToString() ToString() ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Inherited from Component)
Uninstall(IDictionary) Uninstall(IDictionary) Uninstall(IDictionary) Uninstall(IDictionary)

Quando sottoposto a override in una classe derivata, rimuove un'installazione.When overridden in a derived class, removes an installation.

(Inherited from Installer)

Eventi

AfterInstall AfterInstall AfterInstall AfterInstall

Viene generato dopo l'esecuzione dei metodi Install(IDictionary) di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Inherited from Installer)
AfterRollback AfterRollback AfterRollback AfterRollback

Si verifica dopo il rollback delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after the installations of all the installers in the Installers property are rolled back.

(Inherited from Installer)
AfterUninstall AfterUninstall AfterUninstall AfterUninstall

Viene generato dopo l'esecuzione delle operazioni di disinstallazione di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after all the installers in the Installers property perform their uninstallation operations.

(Inherited from Installer)
BeforeInstall BeforeInstall BeforeInstall BeforeInstall

Si verifica dopo l'esecuzione del metodo Install(IDictionary) di ogni programma di installazione contenuto nella raccolta Installer.Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Inherited from Installer)
BeforeRollback BeforeRollback BeforeRollback BeforeRollback

Viene generato prima del rollback dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property are rolled back.

(Inherited from Installer)
BeforeUninstall BeforeUninstall BeforeUninstall BeforeUninstall

Viene generato prima dell'esecuzione delle operazioni di disinstallazione dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property perform their uninstall operations.

(Inherited from Installer)
Committed Committed Committed Committed

Si verifica dopo l'esecuzione del commit delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after all the installers in the Installers property have committed their installations.

(Inherited from Installer)
Committing Committing Committing Committing

Si verifica prima dell'esecuzione del commit delle installazioni dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property commit their installations.

(Inherited from Installer)
Disposed Disposed Disposed Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Si applica a

Vedi anche