MessageQueue.Authenticate Propriété

  • Référence

Définition

Espace de noms:
System.Messaging
Assembly:
System.Messaging.dll

Obtient ou définit une valeur qui indique si la file d'attente accepte uniquement les messages authentifiés.

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é

Boolean

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

Attributs
MessagingDescriptionAttribute

Exceptions

MessageQueueException

Une erreur s'est produite lors de l'accès à une méthode Message Queuing.

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.

Mode groupe de travail Disponible
Ordinateur local Oui
Ordinateur local et nom de format direct Oui
Ordinateur distant Non
Ordinateur distant et nom de format direct Non

S’applique à

Voir aussi