MessageQueue.EncryptionRequired 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 non privés (non chiffrés).

public:
 property System::Messaging::EncryptionRequired EncryptionRequired { System::Messaging::EncryptionRequired get(); void set(System::Messaging::EncryptionRequired value); };
[System.Messaging.MessagingDescription("MQ_EncryptionRequired")]
public System.Messaging.EncryptionRequired EncryptionRequired { get; set; }
[<System.Messaging.MessagingDescription("MQ_EncryptionRequired")>]
member this.EncryptionRequired : System.Messaging.EncryptionRequired with get, set
Public Property EncryptionRequired As EncryptionRequired

Valeur de propriété

EncryptionRequired

Une des valeurs de l'objet EncryptionRequired. La valeur par défaut est None.

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 EncryptionRequired messages.

// Set the queue's EncryptionRequired property value.
queue.EncryptionRequired = System.Messaging.EncryptionRequired.Optional;

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

Remarques

Lorsque vous spécifiez que le chiffrement est requis pour les messages envoyés à une file d’attente, seuls les corps des messages sont chiffrés. Les autres membres (par exemple, les Label propriétés et SenderId ) ne peuvent pas être chiffrés.

La définition de cette propriété modifie la file d’attente Message Queuing. Par conséquent, toutes les autres MessageQueue instances sont affectées par la modification.

Le chiffrement d’un message rend le message privé. Vous pouvez spécifier l’exigence de chiffrement de la file d’attente comme étant None, Bodyou Optional en définissant la EncryptionRequired propriété de manière appropriée. Le UseEncryption paramètre du message doit correspondre à l’exigence de chiffrement de la file d’attente. Si le message n’est pas chiffré, mais que la file d’attente spécifie Body, ou si le message est chiffré mais que la file d’attente spécifie None, le message est rejeté par la file d’attente. Si l’application émettrice demande un message d’accusé de réception négatif dans cet événement, Message Queuing indique le rejet du message à l’application émettrice. Si la propriété a la UseDeadLetterQueue valeur true, un message qui échoue au chiffrement est envoyé à la file d’attente de lettres mortes. Sinon, le message est perdu.

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