Bagikan melalui

MessageQueue.Category Properti

  • Referensi

Definisi

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

Mendapatkan atau mengatur kategori antrean.

public:
 property Guid Category { Guid get(); void set(Guid value); };
[System.Messaging.MessagingDescription("MQ_Category")]
public Guid Category { get; set; }
[<System.Messaging.MessagingDescription("MQ_Category")>]
member this.Category : Guid with get, set
Public Property Category As Guid

Nilai Properti

Guid

Guid yang mewakili kategori antrean (pengidentifikasi jenis Antrean Pesan), yang memungkinkan aplikasi untuk mengategorikan antreannya. Default adalah Guid.empty.

Atribut
MessagingDescriptionAttribute

Pengecualian

ArgumentException

Kategori antrean diatur ke nilai yang tidak valid.

MessageQueueException

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

Contoh kode berikut mendapatkan dan menetapkan nilai properti antrean Category pesan.

// Set the queue's Category property value.
queue.Category =
    new System.Guid("00000000-0000-0000-0000-000000000001");

// Display the new value of the queue's Category property.
Console.WriteLine("MessageQueue.Category: {0}", queue.Category);

Keterangan

Kategori antrean memungkinkan aplikasi untuk mengategorikan antreannya. Misalnya, Anda dapat menempatkan semua antrean Penagihan dalam satu kategori dan semua antrean Pesanan di kategori lainnya.

Properti Category menyediakan akses ke properti ID Jenis Antrean Pesan (yang dibaca/ditulis), dapat diakses melalui kotak dialog Properti Antrean di Konsol Manajemen Komputer. Anda dapat menentukan kategori baru. Meskipun Anda dapat menggunakan NewGuid untuk membuat nilai kategori yang unik di semua Guid nilai, tindakan tersebut tidak perlu. Nilai kategori harus berbeda hanya dari kategori lain, bukan dari semua nilai lainnya Guid . Misalnya, Anda dapat menetapkan {00000000-0000-0000-0000-000000000001} sebagai Category untuk satu set antrean dan {00000000-0000-0000-0000-000000000002} sebagai Category untuk set lain.

Tidak perlu mengatur Category. Nilainya bisa null.

Mengatur properti ini memodifikasi antrean Antrean Pesan. Oleh karena itu, instans lain MessageQueue dipengaruhi oleh perubahan.

Tabel berikut ini memperlihatkan apakah properti ini tersedia dalam berbagai mode Grup Kerja.

Mode grup kerja Tersedia
Komputer lokal Ya
Komputer lokal dan nama format langsung Ya
Komputer jarak jauh Tidak
Komputer jarak jauh dan nama format langsung Tidak

Berlaku untuk

Lihat juga