MessageQueue.EncryptionRequired Properti

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah antrean hanya menerima pesan non-privat (tidak terenkripsi).

public:
 property System::Messaging::EncryptionRequired EncryptionRequired { System::Messaging::EncryptionRequired get(); void set(System::Messaging::EncryptionRequired value); };

[System.Messaging.MessagingDescription("MQ_EncryptionRequired")]
public System.Messaging.EncryptionRequired EncryptionRequired { get; set; }

[<System.Messaging.MessagingDescription("MQ_EncryptionRequired")>]
member this.EncryptionRequired : System.Messaging.EncryptionRequired with get, set

Public Property EncryptionRequired As EncryptionRequired

Nilai Properti

EncryptionRequired

Salah EncryptionRequired satu nilai. Default adalah None.

Atribut

MessagingDescriptionAttribute

Pengecualian

MessageQueueException

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

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

// Set the queue's EncryptionRequired property value.
queue.EncryptionRequired = System.Messaging.EncryptionRequired.Optional;

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

Keterangan

Ketika Anda menentukan bahwa enkripsi diperlukan untuk pesan yang dikirim ke antrean, hanya badan pesan yang dienkripsi. Anggota lain (misalnya, Label properti dan SenderId ) tidak dapat dienkripsi.

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

Mengenkripsi pesan membuat pesan menjadi privat. Anda dapat menentukan persyaratan enkripsi antrean menjadi None, , Bodyatau Optional dengan mengatur EncryptionRequired properti dengan tepat. Pengaturan UseEncryption pesan harus sesuai dengan persyaratan enkripsi antrean. Jika pesan tidak dienkripsi tetapi antrean menentukan Body, atau jika pesan dienkripsi tetapi antrean menentukan None, pesan ditolak oleh antrean. Jika aplikasi pengirim meminta pesan pengakuan negatif dalam peristiwa ini, Antrean Pesan menunjukkan penolakan pesan ke aplikasi pengirim. UseDeadLetterQueue Jika properti adalah true, pesan yang gagal enkripsi dikirim ke antrean dead-letter. Jika tidak, pesan akan hilang.

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

Lihat juga

• Acknowledgment
• UseEncryption