System.Messaging Namespace

Referenz

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.

Dieser Namespace stellt Klassen für folgende Aufgaben zur Verfügung: Herstellen von Verbindungen mit Meldungswarteschlangen im Netzwerk, Überwachen und Verwalten von Meldungswarteschlangen im Netzwerk sowie Senden, Empfangen und Einsehen von Meldungen.

Klassen

AccessControlEntry	Gibt Zugriffsrechte für einen Vertrauensnehmer (einen Benutzer, eine Gruppe oder einen Computer) für die Ausführung anwendungsspezifischer Implementierungen allgemeiner Aufgaben an.
AccessControlList	Enthält eine Liste von Zugriffssteuerungseinträgen, die Zugriffsrechte für einen oder mehrere Vertrauensnehmer angeben.
ActiveXMessageFormatter	Serialisiert bzw. deserialisiert primitive Datentypen und andere Objekte aus oder in den Text einer Message Queuing-Meldung. Dabei wird ein Format verwendet, das mit der ActiveX-Komponente von MSMQ kompatibel ist.
BinaryMessageFormatter	Serialisiert bzw. deserialisiert ein Objekt oder ein ganzes Diagramm verbundener Objekte unter Verwendung eines binären Formats in bzw. aus dem Text einer Message Queuing-Meldung.
Cursor	Beim Lesen der Meldungen einer Warteschlange wird mit einem Cursor eine bestimmte Position in dieser MessageQueue beizubehalten.
DefaultPropertiesToSend	Gibt die Standardwerte für Eigenschaften an, die beim Senden von Objekten (mit Ausnahme von Message-Instanzen) an eine Meldungswarteschlange verwendet werden.
Message	Stellt den Zugriff auf die Eigenschaften bereit, die zur Definition einer Message Queuing-Meldung erforderlich sind.
MessageEnumerator	Stellt einen Vorwärtscursor zum Aufzählen der Nachrichten in einer Nachrichtenwarteschlange bereit.
MessagePropertyFilter	Steuert und wählt die Eigenschaften aus, die beim Einsehen oder beim Empfang von Meldungen aus einer Warteschlange abgerufen werden.
MessageQueue	Ermöglicht den Zugriff auf eine Warteschlange auf einem Message Queuing-Server.
MessageQueueAccessControlEntry	Gibt Zugriffsrechte für einen Vertrauensnehmer (Benutzer, Gruppe oder Computer) für die Durchführung von Message Queuing-Aufgaben an.
MessageQueueCriteria	Filtert Meldungswarteschlangen beim Durchführen einer Abfrage mit der MessageQueue-Methode der GetPublicQueues()-Klasse.
MessageQueueEnumerator	Stellt einen Vorwärtscursor zum Aufzählen der Nachrichten in einer Nachrichtenwarteschlange bereit.
MessageQueueException	Die Ausnahme, die ausgelöst wird, wenn ein interner Fehler von Microsoft Message Queuing auftritt.
MessageQueueInstaller	Ermöglicht das Installieren und Konfigurieren einer Warteschlange, die für das Ausführen einer Anwendung benötigt wird. Diese Klasse wird vom Installationsprogramm, z. B. InstallUtil.exe, beim Installieren einer MessageQueue aufgerufen.
MessageQueuePermission	Ermöglicht das Steuern von Codezugriffsberechtigungen für Messaging.
MessageQueuePermissionAttribute	Ermöglicht deklarative MessageQueue-Berechtigungsüberprüfungen.
MessageQueuePermissionEntry	Definiert die kleinste Einheit einer Berechtigung für die Codezugriffssicherheit, die für Messaging festgelegt ist.
MessageQueuePermissionEntryCollection	Enthält eine stark typisierte Auflistung von MessageQueuePermissionEntry-Objekten.
MessageQueueTransaction	Stellt eine interne Message Queuing-Transaktion bereit.
MessagingDescriptionAttribute	Gibt die Beschreibung einer Eigenschaft oder eines Ereignisses an.
PeekCompletedEventArgs	Stellt Daten für das PeekCompleted-Ereignis bereit. Beim Aufruf eines Ereignishandlers durch die asynchrone Leseanweisung wird eine Instanz dieser Klasse an den Handler übergeben.
ReceiveCompletedEventArgs	Stellt Daten für das ReceiveCompleted-Ereignis bereit. Beim Aufruf eines Ereignishandlers durch eine asynchrone Receive-Methode wird eine Instanz dieser Klasse an den Handler übergeben.
SecurityContext	Stellt den Sicherheitskontext für eine Meldung in einer Warteschlange dar.
Trustee	Gibt ein Benutzerkonto, ein Gruppenkonto oder eine Anmeldesitzung an, auf das bzw. die sich ein Zugriffssteuerungseintrag bezieht.
XmlMessageFormatter	Serialisiert und deserialisiert mithilfe des auf XSD (XML Schema Definition) beruhenden XML-Formats Objekte in den oder aus dem Textkörper einer Meldung.

Schnittstellen

IMessageFormatter

Serialisiert bzw. deserialisiert Objekte aus dem Text einer Message Queuing-Meldung.

Enumerationen

AccessControlEntryType	Gibt an, ob Zugriffsrechte für einen Vertrauensnehmer erteilt, verweigert oder widerrufen werden.
AcknowledgeTypes	Gibt die Typen von Bestätigungsmeldungen an, die Message Queuing an die sendende Anwendung zurückgibt.
Acknowledgment	Gibt das Ergebnis der versuchten Übermittlung einer Meldung an.
CryptographicProviderType	Gibt die Kryptographiedienstanbieter an, die für das Überprüfen digitaler Signaturen verfügbar sind.
EncryptionAlgorithm	Gibt den Verschlüsselungsalgorithmus an, mit dem der Meldungstext einer privaten Meldung verschlüsselt wird.
EncryptionRequired	Gibt die Sicherheitsebene von Meldungen an, die von der Warteschlange empfangen werden.
GenericAccessRights	Gibt unter Verwendung des Zugriffsformats von Windows 2000 oder Windows NT einen Satz allgemeiner Zugriffsrechte an, das Message Queuing sowohl Standardzugriffsrechten als auch objektspezifischen Zugriffsrechten für Lesen, Schreiben und Ausführen zuordnet.
HashAlgorithm	Gibt den Hashalgorithmus an, der von Message Queuing zum authentifizieren von Meldungen verwendet wird.
MessageLookupAction	Gibt eine Meldung in einer Meldungswarteschlange an, die eingesehen oder empfangen werden soll.
MessagePriority	Gibt die Priorität an, die Message Queuing einer Meldung auf dem Weg zu einer Warteschlange und beim Einfügen der Meldung in die Zielwarteschlage zuweist.
MessageQueueAccessRights	Gibt eine Gruppe von objektspezifischen Zugriffsrechten für Operationen an, die spezifisch für Message Queuing sind.
MessageQueueErrorCode	Bezeichnet die Quelle eines Fehlers, der in der Message Queuing-Anwendung aufgetreten ist und eine MessageQueueException-Ausnahme generiert hat.
MessageQueuePermissionAccess	Definiert Zugriffsebenen, die von System.Messaging-Berechtigungsklassen verwendet werden.
MessageQueueTransactionStatus	Gibt den Zustand einer internen Message Queuing-Transaktion an.
MessageQueueTransactionType	Gibt den Typ einer Message Queuing-Transaktion an.
MessageType	Gibt den Typ einer Meldung an. Eine Meldung kann eine typische Message Queuing-Meldung, eine positive bzw. Eingangs- und Lesebestätigung oder eine Berichtsmeldung sein.
PeekAction	Gibt an, ob die aktuelle oder die folgende Meldung in der Warteschlange eingesehen werden soll.
QueueAccessMode	Gibt den Zugriffsmodus für eine MessageQueue zur Erstellungszeit an.
StandardAccessRights	Gibt einen Satz von Standardzugriffsrechten an, die Operationen entsprechen, die den meisten Typen von sicherungsfähigen Objekten gemeinsam sind.
TrusteeType	Gibt den Typ eines Vertrauensnehmers an.

Delegaten

PeekCompletedEventHandler	Stellt die Methode zur Behandlung des PeekCompleted-Ereignisses eines MessageQueue-Objekts dar.
ReceiveCompletedEventHandler	Stellt die Methode zur Behandlung des ReceiveCompleted-Ereignisses eines MessageQueue-Objekts dar.

Hinweise

Member der MessageQueue -Klasse umfassen die folgenden Methoden zum Lesen und Schreiben von Nachrichten in die Warteschlange:

Die Send -Methode ermöglicht es Ihrer Anwendung, Nachrichten in die Warteschlange zu schreiben. Überladungen der -Methode ermöglichen Es Ihnen, anzugeben, ob Ihre Nachricht mithilfe eines Message (das detaillierte Kontrolle über die gesendeten Informationen bietet) oder ein anderes verwaltetes Objekt, einschließlich anwendungsspezifischer Klassen, gesendet werden soll. Die -Methode unterstützt auch das Senden von Nachrichten im Rahmen einer Transaktion.
Die ReceiveMethoden , ReceiveById, und ReceiveByCorrelationId bieten Funktionen zum Lesen von Nachrichten aus einer Warteschlange. Wie die Send -Methode stellen diese Methoden Überladungen bereit, die die Transaktionswarteschlangenverarbeitung unterstützen. Diese Methoden bieten auch Überladungen mit Timeout.

Out-Parameter, mit denen die Verarbeitung fortgesetzt werden kann, wenn die Warteschlange leer ist. Da diese Methoden Beispiele für synchrone Verarbeitung sind, unterbrechen sie den aktuellen Thread, bis eine Nachricht verfügbar ist, es sei denn, Sie geben ein Timeout an.
Die Peek -Methode ähnelt Receive, führt aber nicht dazu, dass eine Nachricht aus der Warteschlange entfernt wird, wenn sie gelesen wird. Da Peek der Inhalt der Warteschlange nicht geändert wird, gibt es keine Überladungen, die die Transaktionsverarbeitung unterstützen. Da Peekjedoch , wie Receive, Nachrichten synchron aus der Warteschlange liest, unterstützen Überladungen der -Methode die Angabe eines Timeouts, um zu verhindern, dass der Thread unbegrenzt wartet.
Die BeginPeekMethoden , EndPeek(IAsyncResult), BeginReceiveund EndReceive(IAsyncResult) bieten Möglichkeiten zum asynchronen Lesen von Nachrichten aus der Warteschlange. Sie unterbrechen den aktuellen Thread nicht, während sie darauf warten, dass eine Nachricht in der Warteschlange eintrifft.

Die folgenden Methoden der MessageQueue -Klasse bieten Funktionen zum Abrufen von Warteschlangenlisten nach angegebenen Kriterien und bestimmen, ob bestimmte Warteschlangen vorhanden sind:

GetPrivateQueuesByMachine(String) ermöglicht den Abruf der privaten Warteschlangen auf einem Computer.
GetPublicQueuesByCategory(Guid), GetPublicQueuesByLabel(String)und GetPublicQueuesByMachine(String) bieten Möglichkeiten, öffentliche Warteschlangen nach allgemeinen Kriterien abzurufen. Eine Überladung von GetPublicQueues bietet noch detailliertere Details für die Auswahl von Warteschlangen basierend auf einer Reihe von Suchkriterien.

Andere Methoden der MessageQueue -Klasse bieten die folgende Funktionalität:

Erstellen und Löschen von Warteschlangen für Nachrichtenwarteschlangen.
Verwenden eines Nachrichtenenumerators, um die Nachrichten in einer Warteschlange zu durchlaufen.
Verwenden eines Warteschlangenumerators zum Durchlaufen der Warteschlangen im System.
Festlegen von ACL-basierten Zugriffsrechten.
Arbeiten mit dem Verbindungscache.

Die Message -Klasse bietet eine detaillierte Kontrolle über die Informationen, die Sie an eine Warteschlange senden, und ist das Objekt, das beim Empfangen oder Anzeigen von Nachrichten aus einer Warteschlange verwendet wird. Neben dem Nachrichtentext umfassen die Eigenschaften der Message Klasse Bestätigungseinstellungen, Formatiererauswahl, Identifikations-, Authentifizierungs- und Verschlüsselungsinformationen, Zeitstempel, Hinweise zur Verwendung der Ablaufverfolgung, Serverjournaling und Unzustellbarkeitswarteschlangen sowie Transaktionsdaten.

Die MessageQueue Komponente ist den folgenden drei Formatierern zugeordnet, mit denen Sie Nachrichten serialisieren und deserialisieren können, die von Warteschlangen gesendet und empfangen werden:

Die XmlMessageFormatter bietet lose gekoppeltes Messaging, das die unabhängige Versionsverwaltung serialisierter Typen auf dem Client und Server ermöglicht.
Der ActiveXMessageFormatter ist mit dem MSMQ-COM-Steuerelement kompatibel. Sie ermöglicht das Senden von Typen, die vom Steuerelement empfangen werden können, und zum Empfangen von Typen, die vom Steuerelement gesendet wurden.
Die BinaryMessageFormatter bietet eine schnellere Alternative zum XmlMessageFormatter, aber ohne den Vorteil von lose gekoppeltem Messaging.

Andere Klassen im Namespace unterstützen Codezugriff Messaging und ACL-basierte Sicherheit, filtern Message Eigenschaften beim Lesen von Nachrichten aus einer Warteschlange und verwenden Transaktionen beim Senden und Empfangen von Nachrichten.

Freigeben über