MessageQueueInstaller Kelas

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

Memungkinkan Anda menginstal dan mengonfigurasi antrean yang dibutuhkan aplikasi Anda untuk berjalan. 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 alat 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 akan 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 memodifikasi informasi status secara eksplisit.

Konstruktor

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

Properti

Authenticate	Mendapatkan atau menetapkan nilai yang menunjukkan apakah antrean yang akan diinstal hanya menerima pesan yang diautentikasi.
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	IContainer Mendapatkan 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 ini Component. (Diperoleh dari Component)
HelpText	Mendapatkan teks bantuan untuk semua 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 menetapkan 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 tempat alat penginstal ini berada. (Diperoleh dari Installer)
Path	Mendapatkan atau mengatur lokasi antrean yang dirujuk oleh objek ini.
Permissions	Mendapatkan atau mengatur izin yang terkait dengan antrean.
Site	Mendapatkan atau mengatur 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

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 properti komponen MessageQueue 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 Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh Component 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 dari instans Type 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 saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnAfterInstall(IDictionary)	Memunculkan kejadian AfterInstall. (Diperoleh dari Installer)
OnAfterRollback(IDictionary)	Memunculkan kejadian AfterRollback. (Diperoleh dari Installer)
OnAfterUninstall(IDictionary)	Memunculkan kejadian AfterUninstall. (Diperoleh dari Installer)
OnBeforeInstall(IDictionary)	Memunculkan kejadian BeforeInstall. (Diperoleh dari Installer)
OnBeforeRollback(IDictionary)	Memunculkan kejadian BeforeRollback. (Diperoleh dari Installer)
OnBeforeUninstall(IDictionary)	Memunculkan kejadian BeforeUninstall. (Diperoleh dari Installer)
OnCommitted(IDictionary)	Memunculkan kejadian Committed. (Diperoleh dari Installer)
OnCommitting(IDictionary)	Memunculkan kejadian 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

AfterInstall	Terjadi setelah Install(IDictionary) metode semua penginstal di Installers properti telah berjalan. (Diperoleh dari Installer)
AfterRollback	Terjadi setelah penginstalan semua penginstal di Installers properti digulung balik. (Diperoleh dari Installer)
AfterUninstall	Terjadi setelah semua 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 penginstal di Installers properti telah melakukan penginstalan mereka. (Diperoleh dari Installer)
Committing	Terjadi sebelum penginstal di Installers properti melakukan penginstalan mereka. (Diperoleh dari Installer)
Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)

Lihat juga

• Installutil.exe (Alat Penginstal)