MessageQueueInstaller.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.
Yüklemeyi gerçekleştirir ve ileti kuyruğu 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.
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
İşleme IDictionary , geri alma veya kaldırma işlemi gerçekleştirmek için gereken bilgileri kaydetmek için kullanılan.
Açıklamalar
Install yöntemi, ileti kuyruğu bilgilerini kayıt defterine yazar ve örneği özelliği tarafından belirtilen yolda bulunan bir kuyrukla ilişkilendirir MessageQueuePath. Kuyruk henüz yoksa, Install işlem kuyruğu oluşturur. Install , içinde belirttiğiniz MessageQueueInstalleryeni veya mevcut kuyruk özelliklerini olarak ayarlar. Kuyruk zaten varsa, özellikleri içindekilere MessageQueueInstallersıfırlanır. Mevcut kuyruk işlemsel değilse silinir ve işlem kuyruğu olarak yeniden oluşturulur.
Dikkat
Kuyruğu yeniden oluşturmak gerekirse, kuyruktaki iletiler kaybolur.
Genellikle, kodunuzun MessageQueueInstaller içinden yöntemini çağırmazsınız; bunlar genellikle yalnızca installutil.exe yükleme yardımcı programı tarafından çağrılır. yardımcı programı, yükleme işlemi sırasında otomatik olarak yöntemini çağırarak Install , yüklenen ileti kuyruğuyla ilişkili kayıt defteri bilgilerini yazar. Yükleme işlemseldir, bu nedenle yükleme sırasında herhangi bir yükleme projesi bileşeninde hata oluşursa, daha önce yüklenen tüm bileşenler yükleme öncesi durumlarına geri alınır. Bu, her bileşenin Rollback yöntemini çağırarak gerçekleştirilir.
Yükleme projesiyle ilişkili tüm bileşenler başarıyla yüklendikten sonra, yükleme yardımcı programı yüklemeleri işler. Commit kuyruğu uygun başlangıç durumuna ayarlayarak yüklemesini MessageQueue tamamlar. özelliği tarafından Path belirtilen kuyruk zaten varsa ve iletileri içeriyorsa, Commit iletileri temizler. Commit Install, yerine iletileri temizler çünkü iletileri temizleme eylemi geri alınamaz.
Bir uygulamanın yükleme yordamı, önceden yüklenmiş bileşenler hakkındaki bilgileri otomatik olarak korumak için proje yükleyicisini Installer.Context kullanır. parametresi olarak stateSaver geçirilen Install bu durum bilgileri, yardımcı program her MessageQueueInstaller örneği yükledikçe sürekli olarak güncelleştirilir. Genellikle kodunuzun bu durum bilgilerini açıkça değiştirmesi gerekmez.