ServiceProcessInstaller Sınıf

Tanım

Ad Alanı:: System.ServiceProcess

Bütünleştirilmiş Kod:: System.ServiceProcess.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

genişleten ServiceBasesınıfları içeren bir yürütülebilir dosya yükler. Bu sınıf, bir hizmet uygulaması yüklenirken InstallUtil.exegibi yükleme yardımcı programları tarafından çağrılır.

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, öğesinden 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ılabilir), 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ı Installers aracılığıyla koleksiyona InstallerCollection.Add 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 yedeklenebilir.

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

#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üklemek istediğiniz hizmetlerle ilişkili kayıt defteri değerlerini yazmak için yükleme yardımcı programı tarafından kullanılır.

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

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

bir örneğinde ServiceProcessInstallerdeğiştirebileceğiniz özellikler arasında, 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ı veya kullanıcı hesabı altında çalıştırılacağını belirtmek için kullanabilirsiniz Account .

Note

Bilgisayarın Sistem hesabı, Yönetici hesabıyla aynı değildir.

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 ServiceProcessInstaller.Install yöntemlerini otomatik olarak çağırırServiceInstaller.Install. Gerekirse, önceden yüklenmiş tüm bileşenlerde (veya Rollback) çağrısı ServiceInstaller.Rollback yaparak hataları geri alır.

Uygulamanın yükleme yordamı, proje yükleyicisinin Installer.Contextkullanarak 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 ComponentInstallerçağrılmalarına neden olur.

Oluşturucular

Name	Description
ServiceProcessInstaller()	sınıfının yeni bir örneğini ServiceProcessInstaller oluşturur.

Özellikler

Name	Description
Account	Bu hizmet uygulamasının altında çalıştırılacak hesap türünü alır veya ayarlar.
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
Context	Geçerli yüklemeyle ilgili bilgileri alır veya ayarlar. (Devralındığı yer: Installer)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
HelpText	Hizmet yükleme seçenekleri için görüntülenen yardım metnini alır.
Installers	Bu yükleyicinin içerdiği yükleyici koleksiyonunu alır. (Devralındığı yer: Installer)
Parent	Bu yükleyicinin ait olduğu koleksiyonu içeren yükleyiciyi alır veya ayarlar. (Devralındığı yer: Installer)
Password	Hizmet uygulamasının çalıştığı kullanıcı hesabıyla ilişkili parolayı alır veya ayarlar.
Site	öğesini alır veya ayarlar ISite Component. (Devralındığı yer: Component)
Username	Hizmet uygulamasının altında çalıştırılacağı kullanıcı hesabını alır veya ayarlar.

Yöntemler

Name	Description
Commit(IDictionary)	Türetilmiş bir sınıfta geçersiz kılındığında yükleme işlemini tamamlar. (Devralındığı yer: Installer)
CopyFromComponent(IComponent)	Sınıfa özgü davranış olmadan CopyFromComponent(IComponent) temel sınıf ServiceProcessInstaller yöntemini uygular.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	tarafından Componentkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	tarafından Component kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: Component)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya Componenttarafından Container sağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
Install(IDictionary)	Hizmet uygulaması bilgilerini kayıt defterine yazar. Bu yöntemin, uygun yöntemleri otomatik olarak çağıran yükleme araçları tarafından kullanılması amaçlanır.
IsEquivalentInstaller(ComponentInstaller)	Belirtilen yükleyicinin bu yükleyiciyle aynı nesneyi yükleyip yüklemediğini belirler. (Devralındığı yer: ComponentInstaller)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
OnAfterInstall(IDictionary)	Olayı tetikler AfterInstall . (Devralındığı yer: Installer)
OnAfterRollback(IDictionary)	Olayı tetikler AfterRollback . (Devralındığı yer: Installer)
OnAfterUninstall(IDictionary)	Olayı tetikler AfterUninstall . (Devralındığı yer: Installer)
OnBeforeInstall(IDictionary)	Olayı tetikler BeforeInstall . (Devralındığı yer: Installer)
OnBeforeRollback(IDictionary)	Olayı tetikler BeforeRollback . (Devralındığı yer: Installer)
OnBeforeUninstall(IDictionary)	Olayı tetikler BeforeUninstall . (Devralındığı yer: Installer)
OnCommitted(IDictionary)	Olayı tetikler Committed . (Devralındığı yer: Installer)
OnCommitting(IDictionary)	Olayı tetikler Committing . (Devralındığı yer: Installer)
Rollback(IDictionary)	Yükleme yordamı tarafından kayıt defterine yazılan hizmet uygulaması bilgilerini geri alır. Bu yöntemin, uygun yöntemleri otomatik olarak işleyen yükleme araçları tarafından kullanılması amaçlanır.
ToString()	Varsa, adını Stringiçeren bir Component döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)
Uninstall(IDictionary)	Türetilmiş bir sınıfta geçersiz kılındığında, yüklemeyi kaldırır. (Devralındığı yer: Installer)

Ekinlikler

Name	Description
AfterInstall	özelliğindeki Install(IDictionary) tüm yükleyicilerin Installers yöntemleri çalıştırıldıktan sonra gerçekleşir. (Devralındığı yer: Installer)
AfterRollback	özelliğindeki tüm yükleyicilerin yüklemeleri Installers geri alındıktan sonra gerçekleşir. (Devralındığı yer: Installer)
AfterUninstall	özelliğindeki Installers tüm yükleyiciler kaldırma işlemlerini gerçekleştirdikten sonra gerçekleşir. (Devralındığı yer: Installer)
BeforeInstall	Yükleyici koleksiyonundaki Install(IDictionary) her yükleyicinin yöntemi çalışmadan önce gerçekleşir. (Devralındığı yer: Installer)
BeforeRollback	özelliğindeki Installers yükleyiciler geri almadan önce gerçekleşir. (Devralındığı yer: Installer)
BeforeUninstall	özelliğindeki Installers yükleyiciler kaldırma işlemlerini gerçekleştirmeden önce gerçekleşir. (Devralındığı yer: Installer)
Committed	özelliğindeki tüm yükleyiciler Installers yüklemelerini işledikten sonra gerçekleşir. (Devralındığı yer: Installer)
Committing	özelliğindeki Installers yükleyiciler yüklemelerini işlemeden önce gerçekleşir. (Devralındığı yer: Installer)
Disposed	Bileşen yöntemine Dispose() yapılan bir çağrıyla atıldığında gerçekleşir. (Devralındığı yer: Component)

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?