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.
Ö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 nesnede çağırarak Rollback 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. parametresi olarak Install geçirilen stateSaver 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.
ServiceProcessInstaller Proje 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.
Hizmet yüklemek için sınıfından Installer devralan bir proje yükleyici sınıfı oluşturun ve sınıfında özniteliğini olarak RunInstallerAttributeayarlayıntrue. 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 ServiceProcessInstaller örneklerini kullanarak ServiceInstaller hizmetin yükleme özelliklerini ayarlayın ve örnekleri koleksiyona Installers ekleyin.
Note
Yükleyici örnekleri eklemek için oluşturucuyu kullanmanız önerilir; ancak, yöntemindeki Installers koleksiyona eklemeniz gerekiyorsa, yönteminde Install koleksiyona aynı eklemeleri gerçekleştirdiğinizden Uninstall emin olun.
sınıfından Installer türetilen tüm sınıflar için ve yöntemlerinde InstallersInstallUninstall koleksiyonun durumu 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.
