Aracılığıyla paylaş

MessageQueue.EncryptionRequired Özellik

  • Başvuru

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

Şunlara uygulanır

Ayrıca bkz.