MessageQueue.EncryptionRequired Özellik

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

Kuyruğun yalnızca özel olmayan (şifrelenmemiş) iletileri kabul edip etmediğini belirten bir değer alır veya ayarlar.

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

Özellik Değeri

EncryptionRequired

Değerlerden EncryptionRequired biri. Varsayılan değer: None.

Öznitelikler

MessagingDescriptionAttribute

Özel durumlar

MessageQueueException

Message Queuing yöntemine erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, ileti kuyruğunun EncryptionRequired özelliğinin değerini alır ve ayarlar.

// 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);

Açıklamalar

Kuyruğa gönderilen iletiler için şifrelemenin gerekli olduğunu belirttiğinizde, yalnızca ileti gövdeleri şifrelenir. Diğer üyeler (örneğin, Label ve SenderId özellikleri) şifrelenemez.

Bu özelliğin ayarlanması Message Queuing kuyruğunda değişiklik gösterir. Bu nedenle, diğer MessageQueue tüm örnekler değişiklikten etkilenir.

İletinin şifrelenmesi, iletinin özel olmasını sağlar. Kuyruğun şifreleme gereksinimini None, Bodyveya Optional özelliğini uygun şekilde ayarlayarak EncryptionRequired belirtebilirsiniz. İletinin UseEncryption ayarı kuyruğun şifreleme gereksinimine karşılık gelir. İleti şifrelenmemişse ancak kuyruk öğesini belirtiyorsa Bodyveya ileti şifreliyse ancak kuyruk belirtiyorsa None, ileti kuyruk tarafından reddedilir. Gönderen uygulama bu olayda olumsuz bir onay iletisi isterse, Message Queuing iletinin gönderen uygulamaya reddedilmesini gösterir. UseDeadLetterQueue özelliği isetrue, şifreleme başarısız olan bir ileti teslim edilemeyen ileti kuyruğuna gönderilir. Aksi takdirde, ileti kaybolur.

Aşağıdaki tabloda bu özelliğin çeşitli Çalışma Grubu modlarında kullanılabilir olup olmadığı gösterilmektedir.

Çalışma grubu modu	Mevcut
Yerel bilgisayar	Evet
Yerel bilgisayar ve doğrudan biçim adı	Evet
Uzak bilgisayar	Hayır
Uzak bilgisayar ve doğrudan biçim adı	Hayır

Ayrıca bkz.

• Acknowledgment
• UseEncryption