MessageQueue.EncryptionRequired 屬性

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 價值。 預設值為 None。

屬性

MessagingDescriptionAttribute

例外狀況

範例

以下範例程式碼取得 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 任何實例都會受到這項變更的影響。

加密訊息會讓訊息變得私密。 你可以指定隊列的加密需求為 None， Body或 Optional 透過適當設定 EncryptionRequired 屬性來達成。 UseEncryption訊息的設定必須符合佇列的加密需求。 若訊息未加密但佇列指定 Body，或訊息已加密但隊列指定 None，佇列會拒絕該訊息。 若發送應用程式在此事件中請求負面確認訊息，訊息佇列會表示該訊息已拒絕給發送應用程式。 若屬性 UseDeadLetterQueue 為 true，則加密失敗的訊息會被送入死信佇列。 否則，訊息就會遺失。

下表顯示此特性是否在各種工作群組模式中可用。

另請參閱

• Acknowledgment
• UseEncryption