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

注解

如果指定发送到队列的消息需要加密，则仅对消息正文进行加密。 例如，其他成员 (， Label) 的 和 SenderId 属性无法加密。

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

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

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

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

另请参阅

• Acknowledgment
• UseEncryption