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