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 экземпляры влияют на изменение.

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

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

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

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

• Acknowledgment
• UseEncryption