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

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

Proprietà facoltative impostate sull'installazione del processo e il servizio prima di aggiungere i programmi di installazione di Installers raccolta.Optional properties are set on the process installer and the service installers before the installers are added to the Installers collection. Quando si accede all'utilità di installazione a MyProjectInstaller, gli oggetti aggiunti al Installers raccolta tramite una chiamata a InstallerCollection.Add verrà installato 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 informazioni sullo stato che indica gli oggetti che sono stati installati, in modo che ogni oggetto possa essere escluse a sua volta in caso di un 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, si potrebbe non crea un'istanza di classe del programma di installazione del progetto in modo esplicito.Normally, you would not instantiate your project installer class explicitly. È necessario crearla e aggiungere il RunInstallerAttribute, ma effettivamente chiama l'utilità di installazione e quindi crea un'istanza, la 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
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 esegue operazioni comuni a tutti i servizi in un file eseguibile.The ServiceProcessInstaller does work common to all services in an executable. Utilizzato dall'utilità di installazione di 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 di programma di installazione di progetto che eredita da Installere impostare il RunInstallerAttribute della classe su true.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'istanza ServiceProcessInstaller istanza per ogni applicazione di servizio e quello ServiceInstaller istanza per ogni servizio dell'applicazione.Within your project, instantiate one ServiceProcessInstaller instance per service application, and one ServiceInstaller instance for each service in the application. Infine, aggiungere il ServiceProcessInstaller istanza e il ServiceInstaller istanze di classe del programma di installazione del progetto.Finally, add the ServiceProcessInstaller instance and the ServiceInstaller instances to your project installer class.

Quando viene eseguito InstallUtil.exe, l'utilità Cerca classi nell'assembly del servizio con il 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 per l'assembly del servizio vengono aggiunte al 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 di progetto.If RunInstallerAttribute is false, the install utility ignores the project installer.

Per un'istanza di ServiceProcessInstaller, le proprietà modificabili includono la specifica che un'applicazione di servizio eseguito 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 un determinato Username e Password coppia in cui il servizio deve essere eseguito o è possibile usare Account per specificare che il servizio eseguito con l'account del computer del sistema, una variabile locale o account del servizio 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

Account di sistema del computer non è quello utilizzato per l'account amministratore.The computer's System account is not the same as the Administrator account.

In genere, non è necessario chiamare i metodi su 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 viene chiamata automaticamente il ServiceProcessInstaller.Install e ServiceInstaller.Install metodi durante il processo di installazione.The install utility automatically calls the ServiceProcessInstaller.Install and ServiceInstaller.Install methods during the installation process. Per il ripristino da errori, se necessario, chiamando Rollback (o ServiceInstaller.Rollback) in tutti i componenti installati in precedenza.It backs out failures, if necessary, by calling Rollback (or ServiceInstaller.Rollback) on all previously installed components.

Routine di installazione di un'applicazione mantiene automaticamente le informazioni relative ai componenti già installati, con l'installazione guidata progetto Installer.Context.An application's install routine maintains information automatically about the components already installed, using the project installer's Installer.Context. Queste informazioni sullo stato viene aggiornate in modo continuo come le ServiceProcessInstaller istanza e ogni ServiceInstaller istanza viene installata dall'utilità.This state information is continuously updated as the ServiceProcessInstaller instance and each ServiceInstaller instance is installed by the utility. Non è in genere necessario per il codice modificare queste informazioni sullo stato in modo esplicito.It is usually unnecessary for your code to modify this state information explicitly.

Creare un'istanza di un ServiceProcessInstaller fa sì che il costruttore di classe di base, ComponentInstaller, da chiamare.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