Teilen über


System.Messaging Namespace

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:

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.