MessageQueue.Authenticate-Eigenschaft

Artikel
08/20/2007

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

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

Syntax

'Declaration
Public Property Authenticate As Boolean
'Usage
Dim instance As MessageQueue
Dim value As Boolean

value = instance.Authenticate

instance.Authenticate = value

public bool Authenticate { get; set; }

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

/** @property */
public boolean get_Authenticate ()

/** @property */
public void set_Authenticate (boolean value)

public function get Authenticate () : boolean

public function set Authenticate (value : boolean)

Eigenschaftenwert

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

Ausnahmen

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

Hinweise

Durch die Authentifizierung von Meldungen kann die Integrität der Meldung gewährleistet und die Identität des Absenders überprüft werden. Die sendende Anwendung fordert eine Authentifizierung an, indem sie die Authentifizierungsebene der Meldung festlegt.

Durch Festlegen von Authenticate auf true wird der Zugriff auf die Warteschlange auf dem Server beschränkt (nicht nur auf diese MessageQueue-Instanz). Dies betrifft alle Clients, die mit derselben Message Queuing-Warteschlange arbeiten.

Eine Warteschlange, die nur authentifizierte Meldungen akzeptiert, lehnt nicht authentifizierte Meldungen ab. Die sendende Anwendung kann durch Festlegen der AcknowledgeType-Eigenschaft der Meldung eine Benachrichtigung über das Ablehnen einer Meldung anfordern. Da das Ablehnen einer Meldung nicht zusätzlich registriert wird, geht die von der Anwendung gesendete Meldung verloren, es sei denn, diese fordert eine Übergabe der Meldung an die Dead Letter-Warteschlange an.

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 Authenticate-Eigenschaft einer Meldungswarteschlange 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);

// Set the queue's Authenticate property value.
queue.set_Authenticate(true);
// Display the new value of the queue's Authenticate property.
Console.WriteLine("MessageQueue.Authenticate: {0}", 
    System.Convert.ToString(queue.get_Authenticate()));

.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
Message.UseDeadLetterQueue-Eigenschaft
Message.AcknowledgeType-Eigenschaft

Freigeben über