MessageQueue.EncryptionRequired 属性

定义

命名空间:

System.Messaging

程序集:

System.Messaging.dll

获取或设置一个指示队列是否只接受非私有（非加密）消息的值。

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

属性值

EncryptionRequired

EncryptionRequired 值之一。 默认值为 None。

属性

MessagingDescriptionAttribute

例外

MessageQueueException

访问“消息队列”方法时出错。

示例

下面的代码示例获取并设置消息队列 EncryptionRequired 属性的值。

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

注解

当指定发送到队列的消息需要加密时，只会加密消息正文。 例如，LabelSenderId无法加密 () 的其他成员。

设置此属性将修改消息队列。 因此，任何其他 MessageQueue 实例都受更改的影响。

加密消息会使消息成为私有消息。 可以指定队列的加密要求，Body或通过Optional适当设置属性来指定EncryptionRequired队列的加密要求None。 UseEncryption消息的设置必须与队列的加密要求相对应。 如果消息未加密，但队列指定 Body，或者如果消息已加密，但队列指定 None，则消息将被队列拒绝。 如果发送应用程序在此事件中请求负确认消息，则消息队列指示消息拒绝发送应用程序。 UseDeadLetterQueue如果该属性为true，则会将加密失败的消息发送到死信队列。 否则，消息将丢失。

下表显示了此属性是否在各种工作组模式下可用。

工作组模式	可用
本地计算机	是
本地计算机和直接格式名称	是
远程计算机	否
远程计算机和直接格式名称	否

另请参阅

• Acknowledgment
• UseEncryption