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 實例都會受到變更的影響。

加密訊息會使訊息成為私人訊息。 您可以適當地設定 屬性，以指定佇列的加密需求NoneOptionalBody。EncryptionRequired 訊息 UseEncryption 的設定必須對應至佇列的加密需求。 如果訊息未加密，但佇列指定 Body，或如果訊息已加密，但佇列指定 None，則佇列會拒絕訊息。 如果傳送的應用程式在此事件中要求負通知訊息，消息佇列表示訊息對傳送應用程式的拒絕。 UseDeadLetterQueue如果 屬性為 true，則會將失敗加密的訊息傳送至寄不出的信件佇列。 否則，訊息會遺失。

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

工作組模式	可用
本機電腦	是
本機計算機和直接格式名稱	是
遠端電腦	否
遠端電腦和直接格式名稱	否

另請參閱

• Acknowledgment
• UseEncryption