MessageQueue.Authenticate 屬性

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

取得或設定值，指出佇列是否只接受已驗證的訊息。

public:
 property bool Authenticate { bool get(); void set(bool value); };

[System.Messaging.MessagingDescription("MQ_Authenticate")]
public bool Authenticate { get; set; }

[<System.Messaging.MessagingDescription("MQ_Authenticate")>]
member this.Authenticate : bool with get, set

Public Property Authenticate As Boolean

屬性值

Boolean

如果佇列只接受驗證過的訊息則為 true，否則為 false。 預設為 false。

屬性

MessagingDescriptionAttribute

例外狀況

MessageQueueException

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

範例

下列程式代碼範例會取得並設定消息佇列 Authenticate 屬性的值。

// Set the queue's Authenticate property value.
queue.Authenticate = true;

// Display the new value of the queue's Authenticate property.
Console.WriteLine("MessageQueue.Authenticate: {0}", queue.Authenticate);

備註

訊息驗證提供一種方式，以確保訊息完整性，以及驗證傳送訊息的人員。 若要要求驗證，傳送的應用程式會設定訊息的驗證層級。

當您設定 Authenticate 為 true時，您會限制存取伺服器上的佇列，而不只是此 MessageQueue 實例。 所有針對相同消息佇列佇列運作的客戶端都會受到影響。

只接受已驗證訊息的佇列將會拒絕未驗證的訊息。 若要要求訊息拒絕通知，傳送的應用程式可以設定 AcknowledgeType 訊息的屬性。 因為沒有其他訊息拒絕的指示存在，所以除非您要求訊息傳送至寄不出的信件佇列，否則傳送的應用程式可能會遺失訊息。

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

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

另請參閱

• UseDeadLetterQueue
• AcknowledgeType