System.Messaging Ruang nama

Menyediakan kelas yang memungkinkan Anda menyambungkan, memantau, dan mengelola antrean pesan di jaringan dan mengirim, menerima, atau mengintip pesan.

Kelas

AccessControlEntry	Menentukan hak akses bagi wali amanat (pengguna, grup, atau komputer) untuk melakukan implementasi tugas umum khusus aplikasi.
AccessControlList	Berisi daftar entri kontrol akses, yang menentukan hak akses untuk satu atau beberapa kepercayaan.
ActiveXMessageFormatter	Menserialisasikan atau mendeserialisasi jenis data primitif dan objek lain ke atau dari isi pesan Antrean Pesan, menggunakan format yang kompatibel dengan Komponen MSMQ ActiveX.
BinaryMessageFormatter	Menserialisasikan atau mendeserialisasi objek, atau seluruh grafik objek yang terhubung, ke atau dari isi pesan Antrean Pesan, menggunakan format biner.
Cursor	Cursor digunakan untuk mempertahankan lokasi tertentu saat MessageQueue membaca pesan antrean.
DefaultPropertiesToSend	Menentukan nilai properti default yang akan digunakan saat mengirim objek selain Message instans ke antrean pesan.
Message	Menyediakan akses ke properti yang diperlukan untuk menentukan pesan Antrean Pesan.
MessageEnumerator	Menyediakan kursor terusan saja untuk menghitung pesan dalam antrean pesan.
MessagePropertyFilter	Mengontrol dan memilih properti yang diambil saat mengintip atau menerima pesan dari antrean pesan.
MessageQueue	Menyediakan akses ke antrean pada server Antrean Pesan.
MessageQueueAccessControlEntry	Menentukan hak akses untuk wali (pengguna, grup, atau komputer) untuk melakukan tugas Antrean Pesan.
MessageQueueCriteria	Memfilter antrean pesan saat melakukan kueri menggunakan MessageQueue metode kelas GetPublicQueues() .
MessageQueueEnumerator	Menyediakan kursor terusan saja untuk menghitung pesan dalam antrean pesan.
MessageQueueException	Pengecualian yang dilemparkan jika terjadi kesalahan internal Antrean Pesan Microsoft.
MessageQueueInstaller	Memungkinkan Anda menginstal dan mengonfigurasi antrean yang dibutuhkan aplikasi Anda untuk berjalan. Kelas ini dipanggil oleh utilitas penginstalan, misalnya, InstallUtil.exe, saat menginstal MessageQueue.
MessageQueuePermission	Memungkinkan kontrol izin akses kode untuk olahpesan.
MessageQueuePermissionAttribute	Mengizinkan pemeriksaan izin deklaratif MessageQueue .
MessageQueuePermissionEntry	Menentukan unit terkecil dari izin keamanan akses kode yang ditetapkan untuk olahpesan.
MessageQueuePermissionEntryCollection	Berisi kumpulan objek yang sangat diketik MessageQueuePermissionEntry .
MessageQueueTransaction	Menyediakan pesan antrean transaksi internal.
MessagingDescriptionAttribute	Menentukan deskripsi untuk properti atau peristiwa.
PeekCompletedEventArgs	Menyediakan data untuk peristiwa tersebut PeekCompleted . Saat operasi intip asinkron Anda memanggil penanganan aktivitas, instans kelas ini diteruskan ke handler.
ReceiveCompletedEventArgs	Menyediakan data untuk peristiwa tersebut ReceiveCompleted . Ketika operasi penerima asinkron Anda memanggil penanganan aktivitas, instans kelas ini diteruskan ke handler.
SecurityContext	Mewakili konteks keamanan untuk pesan dalam antrean.
Trustee	Menentukan akun pengguna, akun grup, atau sesi masuk tempat entri kontrol akses diterapkan.
XmlMessageFormatter	Menserialisasikan dan mendeserialisasi objek ke atau dari isi pesan, menggunakan format XML berdasarkan definisi skema XSD.

Antarmuka

IMessageFormatter

Menserialisasikan atau mendeserialisasi objek dari isi pesan Antrean Pesan.

Enum

AccessControlEntryType	Menentukan apakah akan mengizinkan, menolak, atau mencabut hak akses untuk wali.
AcknowledgeTypes	Menentukan jenis pesan pengakuan yang dikembalikan Oleh Antrean Pesan ke aplikasi pengirim.
Acknowledgment	Menentukan hasil pengiriman pesan yang dicoba.
CryptographicProviderType	Menentukan penyedia layanan kriptografi yang tersedia untuk memvalidasi tanda tangan digital.
EncryptionAlgorithm	Menentukan algoritma enkripsi yang digunakan untuk mengenkripsi isi pesan pesan privat.
EncryptionRequired	Menentukan tingkat privasi pesan yang diterima oleh antrean.
GenericAccessRights	Menggunakan format akses Windows 2000 dan Windows NT untuk menentukan sekumpulan hak akses umum yang dipetakan Antrean Pesan ke hak akses standar dan khusus objek untuk membaca, menulis, dan mengeksekusi.
HashAlgorithm	Menentukan algoritma hash yang digunakan oleh Antrean Pesan saat mengautentikasi pesan.
MessageLookupAction	Menentukan pesan yang akan diintip atau diterima dari antrean pesan.
MessagePriority	Menentukan prioritas Antrean Pesan berlaku untuk pesan saat sedang dalam perjalanan ke antrean, dan saat menyisipkan pesan ke dalam antrean tujuan.
MessageQueueAccessRights	Menentukan sekumpulan hak akses khusus objek untuk operasi khusus untuk Antrean Pesan.
MessageQueueErrorCode	Mengidentifikasi sumber kesalahan yang terjadi dalam aplikasi Antrean Pesan dan menghasilkan MessageQueueException pengecualian.
MessageQueuePermissionAccess	Menentukan tingkat akses yang digunakan oleh System.Messaging kelas izin.
MessageQueueTransactionStatus	Menentukan status transaksi Antrean Pesan internal.
MessageQueueTransactionType	Menentukan jenis transaksi Antrean Pesan.
MessageType	Mengidentifikasi jenis pesan. Pesan dapat berupa pesan Antrean Pesan umum, pesan pengakuan positif (kedatangan dan baca) atau negatif (kedatangan dan baca), atau pesan laporan.
PeekAction	Menunjukkan apakah akan mengintip pesan saat ini dalam antrean, atau pesan berikutnya.
QueueAccessMode	Menentukan mode akses untuk MessageQueue pada waktu pembuatan.
StandardAccessRights	Menentukan sekumpulan hak akses standar yang sesuai dengan operasi yang umum untuk sebagian besar jenis objek yang dapat diamankan.
TrusteeType	Menentukan tipe wali.

Delegasikan

PeekCompletedEventHandler	Mewakili metode yang akan menangani PeekCompleted peristiwa MessageQueue.
ReceiveCompletedEventHandler	Mewakili metode yang akan menangani ReceiveCompleted peristiwa MessageQueue.

Keterangan

Anggota MessageQueue kelas menyertakan metode berikut untuk membaca dan menulis pesan ke antrean:

• Metode ini Send memungkinkan aplikasi Anda menulis pesan ke antrean. Kelebihan beban metode memungkinkan Anda menentukan apakah akan mengirim pesan menggunakan Message (yang memberikan kontrol terperinci atas informasi yang Anda kirim) atau objek terkelola lainnya, termasuk kelas khusus aplikasi. Metode ini juga mendukung pengiriman pesan sebagai bagian dari transaksi.

• Metode Receive, ReceiveById, dan ReceiveByCorrelationId menyediakan fungsionalitas untuk membaca pesan dari antrean. Seperti metode , Send metode ini menyediakan kelebihan beban yang mendukung pemrosesan antrean transaksi. Metode ini juga memberikan kelebihan beban dengan waktu habis.

  Parameter keluar yang memungkinkan pemrosesan untuk melanjutkan jika antrean kosong. Karena metode ini adalah contoh pemrosesan sinkron, metode tersebut mengganggu utas saat ini hingga pesan tersedia, kecuali Anda menentukan waktu habis.

• Metode Peek ini mirip Receivedengan , tetapi tidak menyebabkan pesan dihapus dari antrean saat dibaca. Karena Peek tidak mengubah konten antrean, tidak ada kelebihan beban untuk mendukung pemrosesan transaksi. Namun, karena Peek, seperti Receive, membaca pesan secara sinkron dari antrean, kelebihan beban metode mendukung penentuan waktu habis untuk mencegah utas menunggu tanpa batas waktu.

• Metode BeginPeek, EndPeek(IAsyncResult), BeginReceive, dan EndReceive(IAsyncResult) menyediakan cara untuk membaca pesan secara asinkron dari antrean. Mereka tidak mengganggu utas saat ini sambil menunggu pesan tiba dalam antrean.

Metode MessageQueue kelas berikut menyediakan fungsionalitas untuk mengambil daftar antrean dengan kriteria yang ditentukan dan menentukan apakah antrean tertentu ada:

• GetPrivateQueuesByMachine(String) memungkinkan pengambilan antrean privat pada komputer.

• GetPublicQueuesByCategory(Guid), GetPublicQueuesByLabel(String), dan GetPublicQueuesByMachine(String) menyediakan cara untuk mengambil antrean publik berdasarkan kriteria umum. Kelebihan beban GetPublicQueues memberikan detail yang lebih baik untuk memilih antrean berdasarkan sejumlah kriteria pencarian.

Metode MessageQueue kelas lainnya menyediakan fungsionalitas berikut:

• Membuat dan menghapus antrean Antrean Pesan.

• Menggunakan enumerator pesan untuk menelusuri pesan dalam antrean.

• Menggunakan enumerator antrean untuk iterasi melalui antrean pada sistem.

• Mengatur hak akses berbasis ACL.

• Bekerja dengan cache koneksi.

Kelas Message memberikan kontrol terperinci atas informasi yang Anda kirim ke antrean, dan merupakan objek yang digunakan saat menerima atau mengintip pesan dari antrean. Selain isi pesan, properti Message kelas termasuk pengaturan pengakuan, pemilihan formatter, identifikasi, informasi autentikasi dan enkripsi, tanda waktu, indikasi tentang penggunaan pelacakan, penjurnalan server, dan antrean surat gagal, dan data transaksi.

Komponen MessageQueue ini dikaitkan dengan tiga pemformat berikut, yang memungkinkan Anda untuk membuat serialisasi dan mendeserialisasi pesan yang dikirim dan diterima dari antrean:

• XmlMessageFormatter menyediakan olahpesan yang digabungkan secara longgar, memungkinkan penerapan versi independen dari jenis serial pada klien dan server.

• ActiveXMessageFormatter kompatibel dengan kontrol MSMQ COM. Ini memungkinkan Anda untuk mengirim jenis yang dapat diterima oleh kontrol dan menerima jenis yang dikirim oleh kontrol.

• BinaryMessageFormatter memberikan alternatif yang lebih cepat untuk XmlMessageFormatter, tetapi tanpa manfaat pesan yang digabungkan secara longgar.

Kelas lain di Messaging namespace layanan mendukung akses kode dan keamanan berbasis ACL, memfilter Message properti saat membaca pesan dari antrean, dan menggunakan transaksi saat mengirim dan menerima pesan.