MessageQueue.EncryptionRequired Eigenschaft

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

EncryptionRequired

Einer der EncryptionRequired-Werte. Der Standardwert ist 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 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: