MessageQueue.EncryptionRequired-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public Property EncryptionRequired As EncryptionRequired
'Usage
Dim instance As MessageQueue
Dim value As EncryptionRequired

value = instance.EncryptionRequired

instance.EncryptionRequired = value

public EncryptionRequired EncryptionRequired { get; set; }

public:
property EncryptionRequired EncryptionRequired {
    EncryptionRequired get ();
    void set (EncryptionRequired value);
}

/** @property */
public EncryptionRequired get_EncryptionRequired ()

/** @property */
public void set_EncryptionRequired (EncryptionRequired value)

public function get EncryptionRequired () : EncryptionRequired

public function set EncryptionRequired (value : EncryptionRequired)

Eigenschaftenwert

Einer der EncryptionRequired-Werte. Der Standardwert ist None.

Ausnahmen

Ausnahmetyp	Bedingung
MessageQueueException	Fehler beim Zugriff auf eine Message Queuing-Methode.

Hinweise

Wenn Sie angeben, dass für die an eine Warteschlange gesendeten Meldungen eine Verschlüsselung erforderlich ist, werden nur die Meldungskörper verschlüsselt. Andere Member (z. B. die Label-Eigenschaft oder die SenderId-Eigenschaft) können nicht verschlüsselt werden.

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

Durch das Verschlüsseln wird die Meldung privat. Sie können die Verschlüsselungsanforderung der Warteschlange durch entsprechendes Festlegen der EncryptionRequired-Eigenschaft auf None, Body oder Optional festlegen. Die UseEncryption-Einstellung der Meldung muss der Verschlüsselungsanforderung der Warteschlange entsprechen. Wenn die Meldung nicht verschlüsselt ist, für die Warteschlange aber Body festgelegt wurde, oder wenn die Meldung verschlüsselt ist und für die Warteschlange None festgelegt wurde, wird die Meldung von der Warteschlange abgelehnt. Wenn die sendende Anwendung eine negative Bestätigungsmeldung angefordert hat, informiert Message Queuing die sendende Anwendung über das Ablehnen der Meldung. Wenn die UseDeadLetterQueue-Eigenschaft true ist, wird eine Meldung bei einer nicht übereinstimmenden Verschlüsselung an die Dead Letter-Warteschlange gesendet. Andernfalls geht die Meldung verloren.

Der folgenden Tabelle können Sie entnehmen, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokaler Computer	Ja
Lokaler Computer + direkter Formatname	Ja
Remotecomputer	Nein
Lokaler Computer + direkter Formatname	Nein

Beispiel

Im folgenden Codebeispiel wird der Wert der EncryptionRequired-Eigenschaft einer Meldungswarteschlange 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);

// Set the queue's EncryptionRequired property value.
queue.set_EncryptionRequired(
    System.Messaging.EncryptionRequired.Optional);
// Display the new value of the queue's EncryptionRequired property.
Console.WriteLine("MessageQueue.EncryptionRequired: {0}", 
    queue.get_EncryptionRequired());

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MessageQueue-Klasse
MessageQueue-Member
System.Messaging-Namespace
Acknowledgment-Enumeration
Message.UseEncryption-Eigenschaft

Freigeben über