MessageQueue.EncryptionRequired Egenskap

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

Egenskapsvärde

Ett av EncryptionRequired värdena. Standardvärdet är None.

Attribut

MessagingDescriptionAttribute

Undantag

Exempel

Följande kodexempel hämtar och anger värdet för en meddelandekös EncryptionRequired egenskap.

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

Kommentarer

När du anger att kryptering krävs för de meddelanden som skickas till en kö krypteras endast meddelandeorganen. De andra medlemmarna (till exempel Label egenskaperna och SenderId ) kan inte krypteras.

Om du ställer in den här egenskapen ändras kön för meddelandeköer. Därför påverkas alla andra MessageQueue instanser av ändringen.

Om du krypterar ett meddelande blir meddelandet privat. Du kan ange att köns krypteringskrav ska vara None, Bodyeller Optional genom att ange EncryptionRequired egenskapen på rätt sätt. Inställningen UseEncryption för meddelandet måste motsvara krypteringskravet i kön. Om meddelandet inte är krypterat men kön anger Body, eller om meddelandet är krypterat men kön anger None, avvisas meddelandet av kön. Om det sändande programmet begär ett negativt bekräftelsemeddelande i den här händelsen anger Message Queuing meddelandets avslag på det sändande programmet. Om egenskapen UseDeadLetterQueue är trueskickas ett meddelande som misslyckas med kryptering till kön med obeställbara meddelanden. Annars går meddelandet förlorat.

I följande tabell visas om den här egenskapen är tillgänglig i olika arbetsgruppslägen.

Se även

• Acknowledgment
• UseEncryption