共用方式為


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

屬性

例外狀況

存取訊息佇列方法時發生錯誤。

範例

下列程式代碼範例會取得並設定消息佇列 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 實例都會受到變更的影響。

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

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

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

適用於

另請參閱