Freigeben über


MessageQueue.EncryptionRequired Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Warteschlange lediglich nicht private (nicht verschlüsselte) Meldungen akzeptiert, oder legt diesen fest.

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

Einer der EncryptionRequired-Werte. Der Standardwert ist None.

Attribute

Ausnahmen

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 eine 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 und 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 auf None, Bodyoder Optional festlegen, 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, aber die Warteschlange angibt None, wird die Nachricht von der Warteschlange abgelehnt. Wenn die sendende Anwendung in diesem Ereignis eine negative Bestätigungsmeldung anfordert, gibt Message Queuing die Ablehnung der Nachricht an die sendende Anwendung an. Wenn die UseDeadLetterQueue -Eigenschaft ist true, wird eine Nachricht, bei der die Verschlüsselung fehlschlägt, an die Warteschlange für unzustellbare Nachrichten gesendet. Andernfalls geht die Nachricht verloren.

Die folgende Tabelle zeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokalem Computer Ja
Name des lokalen Computers und direktes Format Ja
Remotecomputer Nein
Name des Remotecomputers und des direkten Formats Nein

Gilt für:

Weitere Informationen