Bagikan melalui

MessageQueueInstaller.Install(IDictionary) Metode

  • Referensi

Definisi

Ruang nama:
System.Messaging
Rakitan:
System.Messaging.dll

Melakukan penginstalan dan menulis informasi antrean pesan ke registri. Metode ini dimaksudkan untuk digunakan oleh alat penginstalan, yang secara otomatis memanggil metode yang sesuai.

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)

Parameter

stateSaver
IDictionary

Yang IDictionary digunakan untuk menyimpan informasi yang diperlukan untuk melakukan operasi penerapan, pembatalan, atau penghapusan instalasi.

Keterangan

Metode ini Install menulis informasi antrean pesan ke registri, dan mengaitkan instans MessageQueue dengan antrean yang terletak di jalur yang ditentukan oleh Path properti . Jika antrean belum ada, Install buat antrean transaksional. Install mengatur properti antrean baru atau yang sudah ada ke properti yang telah Anda tentukan di MessageQueueInstaller. Jika antrean sudah ada, propertinya direset ke properti .MessageQueueInstaller Jika antrean yang ada tidak transaksional, antrean tersebut dihapus lalu dibuat ulang sebagai antrean transaksional.

Perhatian

Jika perlu membuat ulang antrean, pesan dalam antrean akan hilang.

Biasanya, Anda tidak memanggil metode MessageQueueInstaller dari dalam kode Anda; metode umumnya hanya dipanggil oleh utilitas penginstalan installutil.exe. Utilitas secara otomatis memanggil metode selama proses penginstalan untuk menulis informasi registri Install yang terkait dengan antrean pesan yang sedang diinstal. Penginstalan bersifat transaksional, jadi jika ada kegagalan komponen proyek penginstalan selama penginstalan, semua komponen yang diinstal sebelumnya digulung balik ke status pra-penginstalannya. Ini dicapai dengan memanggil metode setiap komponen Rollback .

Setelah penginstalan yang berhasil dari semua komponen yang terkait dengan proyek penginstalan telah terjadi, utilitas penginstalan melakukan penginstalan. Commit menyelesaikan penginstalan MessageQueue dengan mengatur antrean ke status awal yang sesuai. Jika antrean yang ditentukan oleh Path properti sudah ada dan berisi pesan, Commit hapus pesan. Commit, bukan Install, menghapus pesan karena tindakan pembersihan pesan tidak dapat digulung balik.

Rutinitas penginstalan aplikasi menggunakan alat penginstal Installer.Context proyek untuk secara otomatis mempertahankan informasi tentang komponen yang telah diinstal. Informasi status ini, yang diteruskan sebagai InstallstateSaver parameter, terus diperbarui saat utilitas menginstal setiap MessageQueueInstaller instans. Biasanya, kode Anda tidak perlu diubah secara eksplisit.

Berlaku untuk

Lihat juga