MessageQueue.EncryptionRequired Свойство

Определение

Получает или задает значение, указывающее, будет ли очередь принимать только неконфиденциальные (незашифрованные) сообщения.Gets or sets a value that indicates whether the queue accepts only non-private (non-encrypted) messages.

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

Значение свойства

EncryptionRequired

Одно из значений перечисления EncryptionRequired.One of the EncryptionRequired values. Значение по умолчанию — None.The default is None.

Атрибуты

Исключения

При обращении к методу службы очереди сообщений возникла ошибка.An error occurred when accessing a Message Queuing method.

Примеры

В следующем примере кода получается и задается значение свойства очереди сообщений EncryptionRequired .The following code example gets and sets the value of a message queue's EncryptionRequired property.

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

Комментарии

Если указано, что шифрование требуется для сообщений, отправляемых в очередь, шифруются только тексты сообщений.When you specify that encryption is required for the messages sent to a queue, only the message bodies are encrypted. Другие члены (например, Label SenderId Свойства и) не могут быть зашифрованы.The other members (for example, the Label and SenderId properties) cannot be encrypted.

Задание этого свойства изменяет очередь сообщений.Setting this property modifies the Message Queuing queue. В связи с этим MessageQueue изменение затрагивает любые другие экземпляры.Therefore, any other MessageQueue instances are affected by the change.

При шифровании сообщения сообщение становится частным.Encrypting a message makes the message private. Для параметра требования к шифрованию очереди можно задать значение None , Body или, Optional задав EncryptionRequired свойство соответствующим образом.You can specify the queue's encryption requirement to be None, Body, or Optional by setting the EncryptionRequired property appropriately. UseEncryptionПараметр сообщения должен соответствовать требованиям к шифрованию очереди.The UseEncryption setting of the message must correspond to the encryption requirement of the queue. Если сообщение не зашифровано, а очередь указывает Body , или если сообщение зашифровано, а очередь указывает None , сообщение отклоняется очередью.If the message is not encrypted but the queue specifies Body, or if the message is encrypted but the queue specifies None, the message is rejected by the queue. Если отправляющее приложение запрашивает в этом событии отрицательное сообщение подтверждения, очередь сообщений указывает на отклонение сообщения отправляющему приложению.If the sending application requests a negative acknowledgment message in this event, Message Queuing indicates the message's rejection to the sending application. Если UseDeadLetterQueue свойство имеет значение true , сообщение, которое не удается выполнить шифрование, отправляется в очередь недоставленных сообщений.If the UseDeadLetterQueue property is true, a message that fails encryption is sent to the dead-letter queue. В противном случае сообщение будет потеряно.Otherwise, the message is lost.

В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.The following table shows whether this property is available in various Workgroup modes.

Режим рабочей группыWorkgroup mode ДоступноAvailable
Локальный компьютерLocal computer ДаYes
Локальный компьютер и прямое имя форматаLocal computer and direct format name ДаYes
Удаленный компьютерRemote computer НетNo
Удаленный компьютер и прямое имя форматаRemote computer and direct format name НетNo

Применяется к

См. также раздел