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 实例都会受到更改的影响。

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

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

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

另请参阅

• Acknowledgment
• UseEncryption