MessageQueue.EncryptionRequired Eigenschap

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

Waarde van eigenschap

Een van de EncryptionRequired waarden. De standaardwaarde is None.

Kenmerken

MessagingDescriptionAttribute

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt de waarde van de eigenschap van een berichtenwachtrij EncryptionRequired opgehaald en ingesteld.

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

Opmerkingen

Wanneer u opgeeft dat versleuteling vereist is voor de berichten die naar een wachtrij worden verzonden, worden alleen de berichtteksten versleuteld. De andere leden (bijvoorbeeld de Label en SenderId eigenschappen) kunnen niet worden versleuteld.

Als u deze eigenschap instelt, wordt de Message Queuing-wachtrij gewijzigd. Daarom worden alle andere MessageQueue exemplaren beïnvloed door de wijziging.

Als u een bericht versleutelt, wordt het bericht privé. U kunt de versleutelingsvereiste van de wachtrij opgeven, Bodyof Optional door de eigenschap op de EncryptionRequired juiste manier in te Nonestellen. De UseEncryption instelling van het bericht moet overeenkomen met de versleutelingsvereiste van de wachtrij. Als het bericht niet is versleuteld, maar de wachtrij opgeeft Bodyof als het bericht is versleuteld, maar de wachtrij opgeeft None, wordt het bericht geweigerd door de wachtrij. Als de verzendende toepassing in deze gebeurtenis een negatief bevestigingsbericht aanvraagt, geeft Message Queuing de afwijzing van het bericht aan voor de verzendende toepassing. Als de UseDeadLetterQueue eigenschap is true, wordt een bericht dat versleuteling mislukt, verzonden naar de wachtrij met dode letters. Anders gaat het bericht verloren.

In de volgende tabel ziet u of deze eigenschap beschikbaar is in verschillende werkgroepmodi.

Zie ook

• Acknowledgment
• UseEncryption