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.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

Eigenschaftswert

Einer der EncryptionRequired-Werte.One of the EncryptionRequired values. Die Standardeinstellung ist None.The default is None.

Attribute

Ausnahmen

Fehler beim Zugriff auf eine Message Queuing-Methode.An error occurred when accessing a Message Queuing method.

Beispiele

Im folgenden Codebeispiel wird der Wert der-Eigenschaft einer Nachrichten Warteschlange EncryptionRequired abgerufen und festgelegt.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);

Hinweise

Wenn Sie angeben, dass die Verschlüsselung für die an eine Warteschlange gesendeten Nachrichten erforderlich ist, werden nur die Nachrichtentexte verschlüsselt.When you specify that encryption is required for the messages sent to a queue, only the message bodies are encrypted. Die anderen Member (z. b. Label die SenderId -Eigenschaft und die-Eigenschaft) können nicht verschlüsselt werden.The other members (for example, the Label and SenderId properties) cannot be encrypted.

Wenn Sie diese Eigenschaft festlegen, ändert sich die Message Queuing Warteschlange.Setting this property modifies the Message Queuing queue. Aus diesem Grund sind MessageQueue alle anderen Instanzen von der Änderung betroffen.Therefore, any other MessageQueue instances are affected by the change.

Durch das Verschlüsseln einer Nachricht wird die Nachricht als privat angezeigt.Encrypting a message makes the message private. Sie können die Verschlüsselungs Anforderung der Warteschlange Noneals, Bodyoder Optional angeben, indem Sie die EncryptionRequired -Eigenschaft entsprechend festlegen.You can specify the queue's encryption requirement to be None, Body, or Optional by setting the EncryptionRequired property appropriately. Die UseEncryption Einstellung der Nachricht muss der Verschlüsselungs Anforderung der Warteschlange entsprechen.The UseEncryption setting of the message must correspond to the encryption requirement of the queue. Wenn die Nachricht nicht verschlüsselt ist, aber in der BodyWarteschlange angegeben ist, oder wenn die Nachricht verschlüsselt ist None, die Warteschlange jedoch angibt, wird die Nachricht von der Warteschlange abgelehnt.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. Wenn die sendende Anwendung in diesem Ereignis eine negative Bestätigungsnachricht anfordert, gibt Message Queuing die Ablehnung der Nachricht an die sendende Anwendung an.If the sending application requests a negative acknowledgment message in this event, Message Queuing indicates the message's rejection to the sending application. Wenn die UseDeadLetterQueue -Eigenschaft trueist, wird eine Nachricht, die nicht verschlüsselt werden kann, an die Warteschlange für unzustellbare Nachrichten gesendetIf the UseDeadLetterQueue property is true, a message that fails encryption is sent to the dead-letter queue. Andernfalls geht die Nachricht verloren.Otherwise, the message is lost.

In der folgenden Tabelle wird gezeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppen Modi verfügbar ist.The following table shows whether this property is available in various Workgroup modes.

Arbeitsgruppen ModusWorkgroup mode VerfügbarAvailable
Lokaler ComputerLocal computer JaYes
Name des lokalen Computers und des direkten FormatsLocal computer and direct format name JaYes
Remote ComputerRemote computer NeinNo
Name des Remote Computers und des direkten FormatsRemote computer and direct format name NeinNo

Gilt für:

Siehe auch