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; }
member this.EncryptionRequired : System.Messaging.EncryptionRequired with get, set
Public Property EncryptionRequired As 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

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

Дополнительно