MessageQueue.EncryptionRequired Vlastnost

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Získá nebo nastaví hodnotu, která označuje, zda fronta přijímá pouze nesoukromého (nešifrované) zprávy.

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

Hodnota vlastnosti

EncryptionRequired

Jedna z EncryptionRequired hodnot. Výchozí hodnota je None.

Atributy

MessagingDescriptionAttribute

Výjimky

MessageQueueException

Při přístupu k metodě řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu získá a nastaví hodnotu vlastnosti fronty EncryptionRequired zpráv.

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

Poznámky

Když určíte, že šifrování se vyžaduje pro zprávy odeslané do fronty, zašifrují se jenom těla zpráv. Ostatní členy (například Label a SenderId vlastnosti) nelze zašifrovat.

Nastavení této vlastnosti upraví frontu služby Řízení front zpráv. Proto jsou změny ovlivněny všemi dalšími MessageQueue instancemi.

Šifrování zprávy je soukromé. Můžete zadat požadavek na šifrování fronty , NoneBodynebo Optional nastavením EncryptionRequired vlastnosti odpovídajícím způsobem. Nastavení UseEncryption zprávy musí odpovídat požadavku na šifrování fronty. Pokud zpráva není zašifrovaná, ale fronta určuje Body, nebo pokud je zpráva zašifrovaná, ale fronta určuje None, zpráva je odmítnuta frontou. Pokud odesílající aplikace požaduje v této události negativní zprávu potvrzení, služba Řízení front zpráv indikuje odmítnutí zprávy do odesílající aplikace. UseDeadLetterQueue Pokud je truetato vlastnost , zpráva, která selže šifrování, se odešle do fronty nedoručených zpráv. V opačném případě dojde ke ztrátě zprávy.

Následující tabulka ukazuje, zda je tato vlastnost k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	K dispozici
Místní počítač	Ano
Název místního počítače a přímého formátu	Ano
Vzdálený počítač	Ne
Název vzdáleného počítače a přímého formátu	Ne

Viz také

• Acknowledgment
• UseEncryption