MessageQueue.Category Properti

Referensi

Definisi

Ruang nama:: System.Messaging

Rakitan:: System.Messaging.dll

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.

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

Bagikan melalui