MessageQueueInstaller Kelas

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

Memungkinkan Anda menginstal dan mengonfigurasi antrean yang dibutuhkan aplikasi Anda untuk dijalankan. Kelas ini dipanggil oleh utilitas penginstalan, misalnya, InstallUtil.exe, saat menginstal MessageQueue.

public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstaller

public class MessageQueueInstaller : System.Configuration.Install.ComponentInstaller

type MessageQueueInstaller = class
    inherit ComponentInstaller

Public Class MessageQueueInstaller
Inherits ComponentInstaller

Warisan

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Keterangan

MessageQueueInstaller digunakan oleh utilitas penginstalan untuk menulis nilai registri yang terkait dengan antrean. Untuk informasi selengkapnya tentang utilitas penginstalan, lihat Installutil.exe (Alat Penginstal).

Untuk menginstal antrean, buat kelas penginstal proyek yang mewarisi dari Installer, dan atur RunInstallerAttribute untuk kelas ke true. Dalam proyek Anda, buat MessageQueueInstaller instans untuk setiap antrean dalam penginstalan dan tambahkan instans ke kelas penginstal proyek Anda.

Saat membuat MessageQueueInstaller instans, Anda dapat secara opsional meneruskan MessageQueue yang sudah ada (misalnya, dari server pengujian) ke MessageQueueInstaller konstruktor. Pendekatan ini secara otomatis menyediakan pengaturan konfigurasi untuk antrean baru dengan mencerminkan pengaturan antrean yang diteruskan. Atau, Anda dapat mengatur properti secara manual dalam MessageQueueInstaller instans ke status yang Anda inginkan dan memanggil konstruktor tanpa parameter.

Ketika utilitas penginstalan dipanggil, ia mencari RunInstallerAttribute. Jika ya true, utilitas menginstal semua antrean dalam koleksi yang Installers terkait dengan alat penginstal proyek Anda. Jika RunInstallerAttribute adalah false, utilitas mengabaikan alat penginstal proyek.

Anda mengubah properti lain dari MessageQueueInstaller instans baik sebelum atau sesudah menambahkan instans ke Installers koleksi alat penginstal proyek Anda. Misalnya, antrean Path harus diatur sebelum utilitas penginstalan dijalankan.

Biasanya, Anda tidak memanggil metode MessageQueueInstaller dari dalam kode Anda; metode umumnya hanya dipanggil oleh utilitas penginstalan installutil.exe. Utilitas secara otomatis memanggil Install metode selama proses penginstalan dan memanggil Commit jika penginstalan tidak memberikan pengecualian. Ini mendukung kegagalan, jika perlu, dengan memanggil Rollback objek yang menghasilkan pengecualian.

Rutinitas penginstalan aplikasi menggunakan alat penginstal Installer.Context proyek untuk secara otomatis mempertahankan informasi tentang komponen yang telah diinstal. Informasi status ini terus diperbarui karena setiap MessageQueueInstaller instans diinstal oleh utilitas. Biasanya kode Anda tidak perlu mengubah informasi status secara eksplisit.

Konstruktor

Nama	Deskripsi
MessageQueueInstaller()	Menginisialisasi instans baru dari kelas MessageQueueInstaller. Tidak mengatur properti instans apa pun.
MessageQueueInstaller(MessageQueue)	Menginisialisasi instans MessageQueueInstaller baru kelas, menginisialisasi pengaturan penginstalan ke instans yang ada MessageQueue .

Properti

Nama	Deskripsi
Authenticate	Mendapatkan atau menetapkan nilai yang menunjukkan apakah antrean yang akan diinstal hanya menerima pesan terautentikasi.
BasePriority	Mendapatkan atau mengatur prioritas dasar yang digunakan untuk merutekan pesan antrean publik melalui jaringan.
CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Category	Mendapatkan atau mengatur jenis antrean khusus implementasi.
Container	Mendapatkan IContainer yang berisi Component. (Diperoleh dari Component)
Context	Mendapatkan atau mengatur informasi tentang penginstalan saat ini. (Diperoleh dari Installer)
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
EncryptionRequired	Mendapatkan atau menetapkan nilai yang menunjukkan apakah antrean hanya menerima pesan privat, atau terenkripsi.
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke Componentini. (Diperoleh dari Component)
HelpText	Mendapatkan teks bantuan untuk semua alat penginstal dalam koleksi alat penginstal. (Diperoleh dari Installer)
Installers	Mendapatkan kumpulan alat penginstal yang dikandung alat penginstal ini. (Diperoleh dari Installer)
Label	Mendapatkan atau mengatur deskripsi antrean.
MaximumJournalSize	Mendapatkan atau mengatur ukuran maksimum jurnal yang terkait dengan antrean.
MaximumQueueSize	Mendapatkan atau mengatur ukuran maksimum antrean.
MulticastAddress	Diperkenalkan dalam MSMQ 3.0. Mendapatkan atau mengatur alamat multicast yang terkait dengan antrean.
Parent	Mendapatkan atau mengatur alat penginstal yang berisi koleksi milik alat penginstal ini. (Diperoleh dari Installer)
Path	Mendapatkan atau mengatur lokasi antrean yang direferensikan oleh objek ini.
Permissions	Mendapatkan atau mengatur izin yang terkait dengan antrean.
Site	Mengambil atau menetapkan ISite dari Component. (Diperoleh dari Component)
Transactional	Mendapatkan atau menetapkan nilai yang menunjukkan apakah antrean hanya menerima pesan yang dikirim sebagai bagian dari transaksi.
UninstallAction	Mendapatkan atau menetapkan nilai yang menunjukkan apa yang dilakukan alat penginstal dengan antrean pada waktu penghapusan instalasi: menghapusnya, memulihkannya ke status pra-instalasi, atau membiarkannya dalam status terinstal saat ini.
UseJournalQueue	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pesan yang diambil dari antrean juga disalin ke antrean jurnal terkait.

Metode

Nama	Deskripsi
Commit(IDictionary)	Menyelesaikan proses penginstalan dengan menerapkan MessageQueue informasi penginstalan yang Install(IDictionary) ditulis metode ke registri. Metode ini dimaksudkan untuk digunakan oleh alat penginstalan, yang secara otomatis memanggil metode yang sesuai.
CopyFromComponent(IComponent)	Menyalin nilai MessageQueue properti komponen yang diperlukan pada waktu penginstalan untuk antrean pesan.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang digunakan oleh Component. (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang Component digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
Install(IDictionary)	Melakukan penginstalan dan menulis informasi antrean pesan ke registri. Metode ini dimaksudkan untuk digunakan oleh alat penginstalan, yang secara otomatis memanggil metode yang sesuai.
IsEquivalentInstaller(ComponentInstaller)	Menentukan apakah alat penginstal yang ditentukan dapat menangani jenis penginstalan yang sama dengan alat penginstal ini.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
OnAfterInstall(IDictionary)	Menaikkan peristiwa AfterInstall. (Diperoleh dari Installer)
OnAfterRollback(IDictionary)	Menaikkan peristiwa AfterRollback. (Diperoleh dari Installer)
OnAfterUninstall(IDictionary)	Menaikkan peristiwa AfterUninstall. (Diperoleh dari Installer)
OnBeforeInstall(IDictionary)	Menaikkan peristiwa BeforeInstall. (Diperoleh dari Installer)
OnBeforeRollback(IDictionary)	Menaikkan peristiwa BeforeRollback. (Diperoleh dari Installer)
OnBeforeUninstall(IDictionary)	Menaikkan peristiwa BeforeUninstall. (Diperoleh dari Installer)
OnCommitted(IDictionary)	Menaikkan peristiwa Committed. (Diperoleh dari Installer)
OnCommitting(IDictionary)	Menaikkan peristiwa Committing. (Diperoleh dari Installer)
Rollback(IDictionary)	Memulihkan komputer ke status sebelum penginstalan, dengan mengembalikan informasi antrean yang ditulis prosedur penginstalan ke registri. Metode ini dimaksudkan untuk digunakan oleh alat penginstalan, yang secara otomatis memanggil metode yang sesuai.
ToString()	Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)
Uninstall(IDictionary)	Menghapus penginstalan dengan menghapus informasi antrean dari registri. Metode ini dimaksudkan untuk digunakan oleh alat penghapusan instalasi, yang secara otomatis memanggil metode yang sesuai.

Acara

Nama	Deskripsi
AfterInstall	Terjadi setelah Install(IDictionary) metode semua alat penginstal di Installers properti telah berjalan. (Diperoleh dari Installer)
AfterRollback	Terjadi setelah penginstalan semua alat penginstal di Installers properti digulung balik. (Diperoleh dari Installer)
AfterUninstall	Terjadi setelah semua alat penginstal di Installers properti melakukan operasi penghapusan instalasi mereka. (Diperoleh dari Installer)
BeforeInstall	Terjadi sebelum Install(IDictionary) metode setiap alat penginstal dalam koleksi alat penginstal telah berjalan. (Diperoleh dari Installer)
BeforeRollback	Terjadi sebelum alat penginstal di Installers properti digulung balik. (Diperoleh dari Installer)
BeforeUninstall	Terjadi sebelum alat penginstal di Installers properti melakukan operasi penghapusan instalasinya. (Diperoleh dari Installer)
Committed	Terjadi setelah semua alat penginstal di Installers properti melakukan penginstalan mereka. (Diperoleh dari Installer)
Committing	Terjadi sebelum alat penginstal di Installers properti menerapkan penginstalan mereka. (Diperoleh dari Installer)
Disposed	Terjadi ketika komponen dibuang oleh panggilan ke metode Dispose(). (Diperoleh dari Component)

Lihat juga

• Installutil.exe (Alat Penginstal)