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é des messages et de vérifier qui a envoyé le message. Pour demander l’authentification, l’application d’envoi 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, non 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 du message, une application d’envoi peut définir la AcknowledgeType propriété du message. Étant donné qu’aucune autre indication de rejet de message n’existe, l’application d’envoi 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
Nom de l’ordinateur local et du format direct Oui
Ordinateur distant Non
Nom de l’ordinateur distant et du format direct Non

S’applique à

Voir aussi