MessageQueue.EncryptionRequired Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Warteschlange nur nicht private (nicht verschlüsselte) Nachrichten akzeptiert.

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

Eigenschaftswert

EncryptionRequired

Einer der EncryptionRequired Werte. Der Standardwert lautet None.

Attribute

MessagingDescriptionAttribute

Ausnahmen

MessageQueueException

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

Im folgenden Codebeispiel wird der Wert der Eigenschaft einer Nachrichtenwarteschlange EncryptionRequired abgerufen und festgelegt.

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

Hinweise

Wenn Sie angeben, dass die Verschlüsselung für die an eine Warteschlange gesendeten Nachrichten erforderlich ist, werden nur die Nachrichtentexte verschlüsselt. Die anderen Member (z. B. die Label eigenschaften SenderId ) können nicht verschlüsselt werden.

Durch Festlegen dieser Eigenschaft wird die Message Queuing-Warteschlange geändert. Daher sind alle anderen MessageQueue Instanzen von der Änderung betroffen.

Durch das Verschlüsseln einer Nachricht wird die Nachricht privat. Sie können die Verschlüsselungsanforderung der Warteschlange angeben, die erforderlich ist None, Bodyoder Optional indem Sie die EncryptionRequired Eigenschaft entsprechend festlegen. Die UseEncryption Einstellung der Nachricht muss der Verschlüsselungsanforderung der Warteschlange entsprechen. Wenn die Nachricht nicht verschlüsselt ist, aber die Warteschlange angibt Body, oder wenn die Nachricht verschlüsselt ist, die Warteschlange angibt None, wird die Nachricht von der Warteschlange abgelehnt. Wenn die sendende Anwendung in diesem Ereignis eine negative Bestätigungsnachricht anfordert, gibt Message Queuing die Ablehnung der Nachricht an die sendende Anwendung an. Wenn die Eigenschaft lautettrue, wird eine Nachricht, bei der UseDeadLetterQueue die Verschlüsselung fehlschlägt, an die Warteschlange mit inaktiven Buchstaben gesendet. Andernfalls geht die Nachricht verloren.

In der folgenden Tabelle wird gezeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokaler Computer	Ja
Name des lokalen Computers und des direkten Formats	Ja
Remotecomputer	No
Name des Remotecomputers und des direkten Formats	No

Weitere Informationen

• Acknowledgment
• UseEncryption