Aracılığıyla paylaş

MessageQueueInstaller.Install(IDictionary) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Messaging
Bütünleştirilmiş Kod:
System.Messaging.dll

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

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.

Şunlara uygulanır

Ayrıca bkz.