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, в очередь недоставленных сообщений отправляется сообщение с ошибкой шифрования. В противном случае сообщение будет потеряно.

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

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

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

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