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 -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Parametreler
- stateSaver
- IDictionary
bir IDictionary işleme, geri alma veya kaldırma işlemi gerçekleştirmek için gereken bilgileri kaydetmek için kullanılır.
Açıklamalar
Install yöntemi, ileti kuyruğu bilgilerini kayıt defterine yazar ve örneği özelliği tarafından Path belirtilen yolda bulunan bir kuyrukla ilişkilendirirMessageQueue. Kuyruk henüz yoksa işlem Install kuyruğu oluşturur. Install yeni veya mevcut kuyruk özelliklerini içinde belirttiğiniz sıra özelliklerine MessageQueueInstallerayarlar. Kuyruk zaten varsa, özellikleri öğesinin özelliklerine 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, kodunuz içinden yöntemini MessageQueueInstaller ç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, yüklenen ileti kuyruğuyla ilişkili kayıt defteri bilgilerini yazmak için yöntemini otomatik olarak çağırır Install . Yükleme işlemseldir, bu nedenle yükleme sırasında herhangi bir yükleme projesi bileşeninde hata olursa, önceden yüklenmiş olan 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. CommitInstall, yerine iletileri temizler, çünkü iletileri temizleme eylemi geri alınamaz.
Uygulamanın yükleme yordamı, zaten yüklenmiş bileşenlerle ilgili 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.
