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 ne-soukromé (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í formát je None.

Atributy

MessagingDescriptionAttribute

Výjimky

MessageQueueException

Při přístupu k metodě služby Ří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

Pokud určíte, že se pro zprávy odesílané do fronty vyžaduje šifrování, budou šifrována pouze těla zpráv. Ostatní členy (například Label vlastnosti a SenderId ) nelze zašifrovat.

Nastavení této vlastnosti upraví frontu služby Řízení front zpráv. Proto jsou změnou ovlivněny všechny ostatní MessageQueue instance.

Když zprávu zašifrujete, bude zpráva soukromá. Můžete určit požadavek Nonena šifrování fronty , Bodynebo Optional odpovídajícím nastavením EncryptionRequired vlastnosti. 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, bude zpráva odmítnuta frontou. Pokud odesílající aplikace v této události požádá o negativní potvrzení, služba Řízení front zpráv označuje odmítnutí zprávy odesílající aplikaci. UseDeadLetterQueue Pokud je truevlastnost , zpráva, která selže šifrování, se odešle do fronty nedoručených zpráv. V opačném případě se zpráva ztratí.

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č	Yes
Název místního počítače a přímého formátu	Yes
Vzdálený počítač	No
Název vzdáleného počítače a přímého formátu	No

Viz také

• Acknowledgment
• UseEncryption