MessageQueue.Authenticate Eigenschaft

  • Referenz

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

Ruft einen Wert ab, der angibt, ob die Warteschlange nur authentifizierte Meldungen akzeptiert, oder legt diesen fest.

public:
 property bool Authenticate { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MQ_Authenticate")]
public bool Authenticate { get; set; }
[<System.Messaging.MessagingDescription("MQ_Authenticate")>]
member this.Authenticate : bool with get, set
Public Property Authenticate As Boolean

Eigenschaftswert

Boolean

true, wenn die Warteschlange nur authentifizierte Meldungen akzeptiert, andernfalls false. Der Standardwert ist false.

Attribute
MessagingDescriptionAttribute

Ausnahmen

MessageQueueException

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

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

// Set the queue's Authenticate property value.
queue.Authenticate = true;

// Display the new value of the queue's Authenticate property.
Console.WriteLine("MessageQueue.Authenticate: {0}", queue.Authenticate);

Hinweise

Die Nachrichtenauthentifizierung bietet eine Möglichkeit, die Nachrichtenintegrität sicherzustellen und zu überprüfen, wer die Nachricht gesendet hat. Um die Authentifizierung anzufordern, legt die sendende Anwendung die Authentifizierungsebene der Nachricht fest.

Wenn Sie festlegen Authenticate true, beschränken Sie den Zugriff auf die Warteschlange auf dem Server, nicht nur auf diese MessageQueue Instanz. Alle Clients, die mit derselben Message Queuing-Warteschlange arbeiten, sind betroffen.

Eine Warteschlange, die nur authentifizierte Nachrichten akzeptiert, lehnt eine nicht authentifizierte Nachricht ab. Um die Benachrichtigung über die Ablehnung der Nachricht anzufordern, kann eine sendende Anwendung die AcknowledgeType Eigenschaft der Nachricht festlegen. Da keine andere Meldungsausweisung vorhanden ist, kann die Sendende Anwendung die Nachricht verlieren, es sei denn, Sie fordern an, dass sie an die Totbuchstabenwarteschlange gesendet wird.

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

Arbeitsgruppenmodus Verfügbar
Lokalem Computer Ja
Lokaler Computer und direkter Formatname Ja
Remotecomputer Nein
Remotecomputer- und Direkter Formatname Nein

Gilt für

Siehe auch