System.Messaging Ruang nama
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.
