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ğunun değiştirilmesini sağlar. Bu nedenle, diğer MessageQueue tüm örnekler değişiklikten etkilenir.

İletinin şifrelenmesi iletiyi özel hale getirir. 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 şifrelenmişse ancak kuyruk belirtiyorsa None, ileti kuyruk tarafından reddedilir. Gönderen uygulama bu olayda olumsuz bir bildirim iletisi isterse, Message Queuing iletinin gönderen uygulamaya reddini 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	Kullanılabilir
Yerel bilgisayar	Yes
Yerel bilgisayar ve doğrudan biçim adı	Yes
Uzak bilgisayar	No
Uzak bilgisayar ve doğrudan biçim adı	No

Ayrıca bkz.

• Acknowledgment
• UseEncryption