MessageQueue.EncryptionRequired Propriété

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é

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

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

S’applique à

Voir aussi

• Acknowledgment
• UseEncryption