MessageQueue.Authenticate Propriété

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

Valeur de propriété

true si la file d'attente accepte uniquement les messages authentifiés ; sinon, false. La valeur par défaut est false.

Attributs

MessagingDescriptionAttribute

Exceptions

Exemples

L’exemple de code suivant obtient et définit la valeur de la propriété d’une file d’attente de Authenticate messages.

// 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);

Remarques

L’authentification des messages permet de garantir l’intégrité du message et de vérifier qui a envoyé le message. Pour demander l’authentification, l’application émettrice définit le niveau d’authentification du message.

Lorsque vous définissez Authenticate sur true, vous limitez l’accès à la file d’attente sur le serveur, pas seulement à cette MessageQueue instance. Tous les clients travaillant sur la même file d’attente Message Queuing seront affectés.

Une file d’attente qui accepte uniquement les messages authentifiés rejette un message non authentifié. Pour demander une notification de rejet de message, une application émettrice peut définir la AcknowledgeType propriété du message. Étant donné qu’il n’existe aucune autre indication de rejet de message, l’application émettrice peut perdre le message, sauf si vous demandez qu’il soit envoyé à la file d’attente de lettres mortes.

Le tableau suivant indique si cette propriété est disponible dans différents modes de groupe de travail.

S’applique à

Voir aussi

• UseDeadLetterQueue
• AcknowledgeType