ServiceInstaller Sınıf

Tanım

public ref class ServiceInstaller : System::Configuration::Install::ComponentInstaller

public class ServiceInstaller : System.Configuration.Install.ComponentInstaller

type ServiceInstaller = class
    inherit ComponentInstaller

Public Class ServiceInstaller
Inherits ComponentInstaller

Devralma

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceInstaller

Örnekler

Aşağıdaki örnek, adlı ve MyProjectInstaller'den Installerdevralan 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. oluşturucusunun MyProjectInstaller içinde (yükleme yardımcı programı tarafından çağrılabilir), ServiceInstaller bu hizmetlerin her biri için nesneler oluşturulur ve yürütülebilir dosya için bir ServiceProcessInstaller oluşturulur. Yükleme yardımcı programının geçerli bir yükleyici olarak tanınması MyProjectInstallerRunInstallerAttribute 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ı eriştiğindeMyProjectInstaller, ç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ı oluşursa her bir nesne sırayla yedeklenebilir.

Normalde, proje yükleyici sınıfınızın bir örneğini açıkça oluşturmazsınız. Bunu oluşturup söz dizimine özniteliğini eklersiniz RunInstallerAttribute , ancak aslında sınıfı çağıran ve bu nedenle örneği oluşturan yükleme yardımcı programıdı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

, ServiceInstaller ilişkili olduğu hizmete özgü çalışır. Yükleme yardımcı programı tarafından hizmetle ilişkili kayıt defteri değerlerini HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services kayıt defteri anahtarındaki bir alt anahtara yazmak için kullanılır. Hizmet, bu alt anahtar içindeki ServiceName değeriyle tanımlanır. Alt anahtar, hizmetin ait olduğu yürütülebilir dosyanın veya .dll adını da içerir.

Bir hizmeti yüklemek için sınıfından Installer devralan bir proje yükleyici sınıfı oluşturun ve sınıfındaki özniteliğini olarak trueayarlayınRunInstallerAttribute. Projenizde, hizmet uygulaması başına bir ServiceProcessInstaller örnek ve uygulamadaki her hizmet için bir ServiceInstaller örnek oluşturun. Proje yükleyicisi sınıf oluşturucunuzda ve ServiceInstaller örneklerini kullanarak ServiceProcessInstaller hizmetin yükleme özelliklerini ayarlayın ve örnekleri koleksiyona Installers ekleyin.

sınıfından Installer türetilen tüm sınıflar için koleksiyonun Installers durumu ve Uninstall yöntemlerinde Install aynı olmalıdır. Ancak, özel yükleyici sınıfı oluşturucunuzda koleksiyona yükleyici örnekleri eklerseniz ve yöntemleri genelinde InstallUninstall koleksiyonun Installers bakımını yapmaktan kaçınabilirsiniz. Yükleme yardımcı programı çağrıldığında özniteliğini RunInstallerAttribute arar. özniteliği ise true, yardımcı programı proje yükleyicinizle ilişkilendirilmiş koleksiyona Installers eklenen tüm hizmetleri yükler. varsa RunInstallerAttributefalse veya yoksa, yükleme yardımcı programı proje yükleyicisini yoksayar.

Proje ServiceProcessInstaller yükleme sınıfınızla ilişkilendirilmiş olan, projedeki tüm ServiceInstaller örnekler için ortak olan bilgileri yükler. Bu hizmet, yükleme projesindeki diğer hizmetlerden ayıran herhangi bir şeye sahipse, hizmete özgü bilgiler bu yöntemle yüklenir.

Proje yükleyicinizin koleksiyonuna ServiceInstaller eklemeden Installers önce veya ekledikten sonra diğer özellikleri değiştirebilirsiniz. Örneğin, bir hizmet StartType yeniden başlatma sırasında hizmeti otomatik olarak başlatacak veya kullanıcının hizmeti el ile başlatmasını gerektirecek şekilde ayarlanabilir.

Normalde, kodunuzun içinde yöntemlerini ServiceInstaller ç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. Daha önce yüklenmiş tüm bileşenlerde (veya ServiceInstaller.Rollback) çağrısı Rollback yaparak gerekirse hataları geri alır.

Yükleme yardımcı programı, nesneyi kaldırmak için öğesini çağırır Uninstall .

Uygulamanın yükleme yordamı, proje yükleyicisinin Installer.Contextkullanarak zaten yüklü olan bileşenlerle ilgili bilgileri otomatik olarak tutar. Bu durum bilgileri örnek olarak ServiceProcessInstaller sürekli olarak güncelleştirilir ve her ServiceInstaller örnek yardımcı programı tarafından yüklenir. Kodunuzun durum bilgilerini açıkça değiştirmesi genellikle gereksizdir.

Yükleme gerçekleştirildiğinde, türetilen sınıfla ServiceBase ilişkili olay günlüğü kaynağını yüklemek için otomatik olarak bir EventLogInstaller oluşturur. Bu kaynağın Log özelliği, oluşturucu tarafından ServiceInstaller bilgisayarın Uygulama günlüğüne ayarlanır. öğesini ayarladığınızda ServiceNameServiceInstaller (hizmetin değeriyle aynı ServiceBase.ServiceName olmalıdır), Source otomatik olarak aynı değere ayarlanır. Yükleme hatasında, kaynağın yüklemesi önceden yüklenmiş hizmetlerle birlikte geri alınır.

Uninstall yöntemi çalışıyorsa hizmeti durdurmaya çalışır. Bunun başarılı olup olmaması, Uninstall tarafından Installyapılan değişiklikleri geri alır. Olay günlüğü için yeni bir kaynak oluşturulduysa, kaynak silinir.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• ServiceName
• ServiceProcessInstaller
• ServiceBase
• EventLog