ServiceProcessInstaller Sınıf

Tanım

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

Devralma

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

Örnekler

Aşağıdaki örnek, 'den Installerdevralan MyProjectInstaller adlı bir proje yükleyicisi oluşturur. "Hello-World Service 1" ve "Hello-World Service 2" olmak üzere iki hizmet içeren bir hizmet yürütülebilir dosyası olduğu varsayılır. MyProjectInstaller oluşturucusunun içinde (yükleme yardımcı programı tarafından çağrılır), ServiceInstaller her hizmet için nesneler oluşturulur ve yürütülebilir dosya için bir ServiceProcessInstaller oluşturulur. Yükleme yardımcı programının MyProjectInstaller'ı geçerli bir yükleyici olarak tanıması RunInstallerAttribute için özniteliği olarak trueayarlanır.

İsteğe bağlı özellikler, yükleyiciler koleksiyona eklenmeden Installers önce işlem yükleyicisinde ve hizmet yükleyicilerinde ayarlanır. Yükleme yardımcı programı MyProjectInstaller'a eriştiğinde, çağrısı InstallerCollection.Add aracılığıyla koleksiyona Installers eklenen nesneler sırayla yüklenir. İşlem sırasında yükleyici, hangi nesnelerin yüklendiğini belirten durum bilgilerini tutar, böylece yükleme hatası durumunda her nesne sırayla geri yüklenebilir.

Normalde, proje yükleyici sınıfınızı açıkça örneklemezsiniz. Bunu oluşturup eklersiniz RunInstallerAttribute, ancak yükleme yardımcı programı aslında öğesini çağırır ve bu nedenle sınıfını başlatır.

#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

Açıklamalar

yürütülebilir ServiceProcessInstaller dosyadaki tüm hizmetler için ortak çalışır. Yükleme yardımcı programı tarafından yüklemek istediğiniz hizmetlerle ilişkili kayıt defteri değerlerini yazmak için kullanılır.

Bir hizmeti yüklemek için, öğesinden Installerdevralan bir proje yükleyici sınıfı oluşturun ve sınıfında öğesini olarak trueayarlayınRunInstallerAttribute. Projenizde hizmet uygulaması başına bir ServiceProcessInstaller örnek ve uygulamadaki her hizmet için bir ServiceInstaller örnek oluşturun. Son olarak, örneği ve ServiceInstaller örnekleri proje yükleyici sınıfınıza ekleyinServiceProcessInstaller.

InstallUtil.exe çalıştırıldığında, yardımcı programı olarak ayarlanmış truehizmet derlemesindeki RunInstallerAttribute sınıfları arar. Sınıfları proje yükleyicinizle ilişkili koleksiyona ekleyerek hizmet derlemesine Installers ekleyin. ise RunInstallerAttributefalse, yükleme yardımcı programı proje yükleyicisini yoksayar.

bir örneği ServiceProcessInstalleriçin değiştirebileceğiniz özellikler arasında, bir hizmet uygulamasının oturum açmış kullanıcı dışında bir hesap altında çalıştırılacağını belirtme yer alır. Hizmetin altında çalışması gereken belirli Username bir ve Password çifti belirtebilir veya hizmetin bilgisayarın Sistem hesabı, yerel veya ağ hizmet hesabı ya da kullanıcı hesabı altında çalıştırılacağını belirtmek için kullanabilirsiniz Account .

Normalde, kodunuzun içinde üzerinde ServiceInstaller yöntemlerini çağırmazsınız; bunlar genellikle yalnızca yükleme yardımcı programı tarafından çağrılır. Yükleme yardımcı programı, yükleme işlemi sırasında ve ServiceInstaller.Install yöntemlerini otomatik olarak çağırırServiceProcessInstaller.Install. Gerekirse, önceden yüklenmiş tüm bileşenlerde (veya ServiceInstaller.Rollback) çağrısı Rollback yaparak hataları geri alır.

Uygulamanın yükleme yordamı, proje yükleyicisinin Installer.Contextöğesini kullanarak zaten yüklü olan bileşenler hakkındaki bilgileri otomatik olarak korur. Örnek olarak ServiceProcessInstaller bu durum bilgileri sürekli olarak güncelleştirilir ve her ServiceInstaller örnek yardımcı program tarafından yüklenir. Kodunuzun bu durum bilgilerini açıkça değiştirmesi genellikle gereksizdir.

Örneği oluşturmak ServiceProcessInstaller temel sınıf oluşturucusunun çağrılmalarına ComponentInstallerneden olur.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• ServiceInstaller
• ServiceBase
• ComponentInstaller
• Installers
• ServiceAccount
• ServiceInstallerDialog