MessageQueue.EncryptionRequired Свойство

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Получает или задает значение, указывающее, будет ли очередь принимать только неконфиденциальные (незашифрованные) сообщения.

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. Значение по умолчанию — None.

Атрибуты

MessagingDescriptionAttribute

Исключения

MessageQueueException

При обращении к методу службы очереди сообщений возникла ошибка.

Примеры

В следующем примере кода получается и задается значение свойства очереди EncryptionRequired сообщений.

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

Комментарии

Если указать, что для сообщений, отправляемых в очередь, требуется шифрование, шифруются только тела сообщений. Другие элементы (например, Label свойства и SenderId ) не могут быть зашифрованы.

Задание этого свойства изменяет очередь очереди сообщений. Таким образом, изменение влияет на любые другие MessageQueue экземпляры.

Шифрование сообщения делает сообщение закрытым. Для требования к шифрованию Noneочереди можно указать значение , Bodyили Optional , задав EncryptionRequired свойство соответствующим образом. Параметр UseEncryption сообщения должен соответствовать требованию к шифрованию очереди. Если сообщение не зашифровано, но в очереди указано Body, или если сообщение зашифровано, но очередь указывает None, сообщение отклоняется очередью. Если отправляющее приложение запрашивает отрицательное сообщение подтверждения в этом событии, очередь сообщений указывает на отклонение сообщения отправляющим приложением. UseDeadLetterQueue Если свойство имеет значение true, в очередь недоставленных сообщений отправляется сообщение с ошибкой шифрования. В противном случае сообщение будет потеряно.

В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.

Режим рабочей группы	Доступно
Локальный компьютер	Да
Имя локального компьютера и прямого формата	Да
Удаленный компьютер	Нет
Имя удаленного компьютера и прямого формата	Нет

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

• Acknowledgment
• UseEncryption