ServiceInstaller.Install(IDictionary) Yöntem
Tanım
Ö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.
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 -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Parametreler
- stateSaver
- IDictionary
IDictionary Yüklemeyle ilişkili bağlam bilgilerini içeren bir.
Özel durumlar
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ı.
Hizmetin görünen adı 255 karakterden uzundur.
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.
