ServiceInstaller.Install(IDictionary) Yöntem

Tanım

Ad Alanı:

System.ServiceProcess

Bütünleştirilmiş Kod:

System.ServiceProcess.dll

Hizmet uygulaması bilgilerini kayıt defterine yazarak hizmeti yükler. Bu yöntemin, uygun yöntemleri otomatik olarak işleyen yükleme araçları tarafından kullanılması amaçlanır.

public:
 override void Install(System::Collections::IDictionary ^ stateSaver);

public override void Install (System.Collections.IDictionary stateSaver);

override this.Install : System.Collections.IDictionary -> unit

Public Overrides Sub Install (stateSaver As IDictionary)

Parametreler

stateSaver

IDictionary

IDictionary Yüklemeyle ilişkili bağlam bilgilerini içeren bir.

Özel durumlar

InvalidOperationException

Yükleme yürütülebilir dosya için bir ServiceProcessInstaller içermez.

-veya-

Derlemenin dosya adı veya boş bir dizedir null .

-veya-

Hizmet adı geçersiz.

-veya-

Hizmet Denetim Yöneticisi açılamadı.

ArgumentException

Hizmetin görünen adı 255 karakterden uzundur.

Win32Exception

Sistem hizmete tanıtıcı oluşturamadı.

-veya-

Bu ada sahip bir hizmet zaten yüklü.

Açıklamalar

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 sırasında yöntemini otomatik olarak çağırır Install . Gerekirse özel durumu oluşturan nesneyi çağırarak Rollback hataları geri alır.

Uygulamanın yükleme yordamı, proje yükleyicisinin Installer.Contextöğesini kullanarak önceden yüklenmiş olan bileşenler hakkındaki bilgileri otomatik olarak tutar. parametresi olarak stateSaver geçirilen Install bu durum bilgileri, örnek olarak ServiceProcessInstaller 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.

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.

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.

Not

Yükleyici örnekleri eklemek için oluşturucuyu kullanmanız önerilir; ancak yöntemindeki Installers koleksiyona eklemeniz gerekiyorsa, yöntemindeki Install koleksiyona aynı eklemeleri yaptığınızdan Uninstall emin olun.

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.

Ayrıca bkz.

• ServiceProcessInstaller
• Rollback(IDictionary)
• Commit(IDictionary)
• Uninstall(IDictionary)
• EventLogInstaller
• EventLogInstaller()