Exportieren (0) Drucken
Alle erweitern
Erweitern Minimieren

System.Messaging-Namespace

Aktualisiert: November 2007

Der System.Messaging-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.

Member der MessageQueue-Klasse enthalten die folgenden Methoden, mit denen Meldungen gelesen und in die Warteschlange geschrieben werden können:

  • Mit der Send()-Methode kann die Anwendung Meldungen in die Warteschlange schreiben. Mit Überladungen der Methode können Sie angeben, ob die Meldung mit Message (wodurch die präzise Steuerung der zu sendenden Informationen möglich ist) oder einem beliebigen anderen verwalteten Objekt gesendet werden soll, einschließlich anwendungsspezifischer Klassen. Die Methode unterstützt außerdem das Senden von Meldungen im Rahmen einer Transaktion.

  • Die Receive-Methode, die ReceiveById()-Methode und die ReceiveByCorrelationId()-Methode stellen Funktionen zum Lesen von Meldungen aus einer Warteschlange zur Verfügung. Wie die Send()-Methode stellen diese Methoden Überladungen bereit, die die transaktionale Verarbeitung von Warteschlangen unterstützen. Diese Methoden stellen auch Überladungen mit Timeouts bereit.

    Out-Parameter, die die Fortsetzung der Verarbeitung ermöglichen, wenn die Warteschlange leer ist. Da diese Methoden Beispiele für synchrone Verarbeitung sind, unterbrechen sie den aktuellen Thread, bis eine Meldung verfügbar ist, sofern Sie keinen Timeout angeben.

  • Die Peek-Methode ähnelt Receive, die Meldung in der Wartschlange wird nach dem Lesen jedoch nicht entfernt. Da Peek den Inhalt der Warteschlange nicht ändert, sind keine Überladungen vorhanden, die die transaktionale Verarbeitung unterstützen. Da Peek Meldungen jedoch wie Receive synchron aus der Warteschlange liest, kann für Überladungen der Methode ein Timeout angegeben werden, um zu verhindern, dass der Thread eine unbestimmte Zeit wartet.

  • Die Methoden BeginPeek, EndPeek(IAsyncResult), BeginReceive und EndReceive(IAsyncResult) bieten Möglichkeiten zum asynchronen Lesen von Meldungen aus der Warteschlange. Sie unterbrechen den aktuellen Thread nicht, während sie auf den Eingang einer Meldung in der Warteschlange warten.

Die folgenden Methoden der MessageQueue-Klasse stellen Funktionen bereit, mit denen Listen von Warteschlangen anhand bestimmter Kriterien abgerufen und das Vorhandensein bestimmter Warteschlangen bestimmt werden kann:

Weitere Methoden der MessageQueue-Klasse bieten folgende Funktionen:

  • Erstellen und Löschen von Message Queueing-Warteschlangen.

  • Verwenden eines Meldungsenumerators, mit dem die Meldungen in einer Warteschlange schrittweise durchlaufen werden können.

  • Verwenden eines Warteschlangenenumerators zum Durchlaufen der Warteschlangen im System.

  • Festlegen von ACL-basierten Zugriffsrechten.

  • Verwenden des Verbindungscache.

Die Message-Klasse ermöglicht die präzise Steuerung der an eine Warteschlange gesendeten Informationen. Sie stellt das Objekt dar, das beim Empfangen und Einsehen von Meldungen aus einer Warteschlange verwendet wird. Neben dem Meldungstext werden mit den Eigenschaften der Message-Klasse Bestätigungseinstellungen, Auswahl des Formatierungsprogramms, Identifikation, Authentifizierungs- und Verschlüsselungsinformationen, Timestamps, Angaben über Ablaufverfolgung, Serverjournale, Warteschlangen für unzustellbare Nachrichten und Transaktionsdaten festgelegt.

Der MessageQueue-Komponente sind die folgenden drei Formatierungsprogramme zugeordnet, mit denen Sie Meldungen serialisieren oder deserialisieren können, die an Warteschlangen gesendet bzw. aus diesen empfangen wurden:

  • XmlMessageFormatter bietet ein lose verknüpftes Messaging, wobei voneinander unabhängige Versionen serialisierter Typen auf Client und Server erstellt werden können.

  • Das ActiveXMessageFormatter ist mit dem COM-Steuerelement von MSMQ kompatibel. Es ermöglicht Ihnen das Senden von Typen, die vom Steuerelement empfangen werden können, und das Empfangen von Typen, die vom Steuerelement gesendet wurden.

  • Der BinaryMessageFormatter ist schneller als der XmlMessageFormatter, bietet jedoch nicht den Vorteil des lose verknüpften Messaging.

Weitere Klassen im Messaging-Namespace unterstützen Codezugriffssicherheit und Sicherheit auf der Grundlage von ACL, Filtern von Message-Eigenschaften während des Lesens von Meldungen aus einer Warteschlange sowie Verwenden von Transaktionen beim Senden und Empfangen von Meldungen.

  KlasseBeschreibung
xes6983c.pubclass(de-de,VS.90).gifAccessControlEntryGibt Zugriffsrechte für einen Vertrauensnehmer (einen Benutzer, eine Gruppe oder einen Computer) für die Ausführung anwendungsspezifischer Implementierungen allgemeiner Aufgaben an.
xes6983c.pubclass(de-de,VS.90).gifAccessControlListEnthält eine Liste von Zugriffssteuerungseinträgen, die Zugriffsrechte für einen oder mehrere Vertrauensnehmer angeben.
xes6983c.pubclass(de-de,VS.90).gifActiveXMessageFormatterSerialisiert 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.
xes6983c.pubclass(de-de,VS.90).gifBinaryMessageFormatterSerialisiert 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.
xes6983c.pubclass(de-de,VS.90).gifCursorBeim Lesen der Meldungen einer Warteschlange wird mit einem Cursor eine bestimmte Position in dieser MessageQueue beizubehalten.
xes6983c.pubclass(de-de,VS.90).gifDefaultPropertiesToSendGibt die Standardwerte für Eigenschaften an, die beim Senden von Objekten (mit Ausnahme von Message-Instanzen) an eine Meldungswarteschlange verwendet werden.
xes6983c.pubclass(de-de,VS.90).gifMessageStellt den Zugriff auf die Eigenschaften bereit, die zur Definition einer Message Queuing-Meldung erforderlich sind.
xes6983c.pubclass(de-de,VS.90).gifMessageEnumeratorStellt einen Vorwärtscursor zum Durchlaufen der Meldungen in einer Meldungswarteschlange bereit.
xes6983c.pubclass(de-de,VS.90).gifMessagePropertyFilterSteuert und wählt die Eigenschaften aus, die beim Einsehen oder beim Empfang von Meldungen aus einer Warteschlange abgerufen werden.
xes6983c.pubclass(de-de,VS.90).gifMessageQueue Ermöglicht den Zugriff auf eine Warteschlange auf einem Message Queuing-Server.
xes6983c.pubclass(de-de,VS.90).gifMessageQueueAccessControlEntryGibt Zugriffsrechte für einen Vertrauensnehmer (Benutzer, Gruppe oder Computer) für die Durchführung von Message Queuing-Aufgaben an.
xes6983c.pubclass(de-de,VS.90).gifMessageQueueCriteriaFiltert Meldungswarteschlangen beim Durchführen einer Abfrage mit der GetPublicQueues-Methode der MessageQueue-Klasse.
xes6983c.pubclass(de-de,VS.90).gifMessageQueueEnumeratorStellt einen Vorwärtscursor zum Durchlaufen der Meldungen in einer Meldungswarteschlange bereit.
xes6983c.pubclass(de-de,VS.90).gifMessageQueueExceptionDie Ausnahme, die ausgelöst wird, wenn ein interner Fehler in Microsoft Message Queuing auftritt.
xes6983c.pubclass(de-de,VS.90).gifMessageQueueInstallerErmö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.
xes6983c.pubclass(de-de,VS.90).gifMessageQueuePermissionErmöglicht das Steuern von Codezugriffsberechtigungen für Messaging.
xes6983c.pubclass(de-de,VS.90).gifMessageQueuePermissionAttributeErmöglicht deklarative MessageQueue-Berechtigungsüberprüfungen.
xes6983c.pubclass(de-de,VS.90).gifMessageQueuePermissionEntryDefiniert die kleinste Einheit einer Berechtigung für die Codezugriffssicherheit, die für Messaging festgelegt ist.
xes6983c.pubclass(de-de,VS.90).gifMessageQueuePermissionEntryCollectionEnthält eine Auflistung von stark typisierten MessageQueuePermissionEntry-Objekten.
xes6983c.pubclass(de-de,VS.90).gifMessageQueueTransactionStellt eine interne Message Queuing-Transaktion bereit.
xes6983c.pubclass(de-de,VS.90).gifMessagingDescriptionAttributeGibt eine Beschreibung für eine Eigenschaft oder ein Ereignis an.
xes6983c.pubclass(de-de,VS.90).gifPeekCompletedEventArgsStellt Daten für das PeekCompleted-Ereignis bereit. Beim Aufruf eines Ereignishandlers durch die asynchrone Leseanweisung wird eine Instanz dieser Klasse an den Handler übergeben.
xes6983c.pubclass(de-de,VS.90).gifReceiveCompletedEventArgsStellt 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.
xes6983c.pubclass(de-de,VS.90).gifSecurityContextStellt den Sicherheitskontext für eine Meldung in einer Warteschlange dar.
xes6983c.pubclass(de-de,VS.90).gifTrusteeGibt ein Benutzerkonto, ein Gruppenkonto oder eine Anmeldesitzung an, auf das bzw. die sich ein Zugriffssteuerungseintrag bezieht.
xes6983c.pubclass(de-de,VS.90).gifXmlMessageFormatterSerialisiert und deserialisiert mithilfe des auf XSD (XML Schema Definition) beruhenden XML-Formats Objekte in den oder aus dem Textkörper einer Meldung.

  SchnittstelleBeschreibung
xes6983c.pubinterface(de-de,VS.90).gifIMessageFormatterSerialisiert bzw. deserialisiert Objekte aus dem Text einer Message Queuing-Meldung.

  DelegatBeschreibung
xes6983c.pubdelegate(de-de,VS.90).gifPeekCompletedEventHandlerStellt die Methode dar, die das PeekCompleted-Ereignis einer MessageQueue behandelt.
xes6983c.pubdelegate(de-de,VS.90).gifReceiveCompletedEventHandlerStellt die Methode dar, die das ReceiveCompleted-Ereignis einer MessageQueue behandelt.

  EnumerationBeschreibung
xes6983c.pubenumeration(de-de,VS.90).gifAccessControlEntryTypeGibt an, ob Zugriffsrechte für einen Vertrauensnehmer erteilt, verweigert oder widerrufen werden.
xes6983c.pubenumeration(de-de,VS.90).gifAcknowledgeTypesGibt die Typen von Bestätigungsmeldungen an, die Message Queuing an die sendende Anwendung zurückgibt.
xes6983c.pubenumeration(de-de,VS.90).gifAcknowledgmentGibt das Ergebnis der versuchten Übermittlung einer Meldung an.
xes6983c.pubenumeration(de-de,VS.90).gifCryptographicProviderTypeGibt die Kryptographiedienstanbieter an, die für das Überprüfen digitaler Signaturen verfügbar sind.
xes6983c.pubenumeration(de-de,VS.90).gifEncryptionAlgorithmGibt den Verschlüsselungsalgorithmus an, mit dem der Meldungstext einer privaten Meldung verschlüsselt wird.
xes6983c.pubenumeration(de-de,VS.90).gifEncryptionRequiredGibt die Sicherheitsebene von Meldungen an, die von der Warteschlange empfangen werden.
xes6983c.pubenumeration(de-de,VS.90).gifGenericAccessRightsGibt 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.
xes6983c.pubenumeration(de-de,VS.90).gifHashAlgorithmGibt den Hashalgorithmus an, der von Message Queuing beim Authentifizieren von Meldungen verwendet wird.
xes6983c.pubenumeration(de-de,VS.90).gifMessageLookupActionGibt eine Meldung in einer Meldungswarteschlange an, die eingesehen oder empfangen werden soll.
xes6983c.pubenumeration(de-de,VS.90).gifMessagePriorityGibt 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.
xes6983c.pubenumeration(de-de,VS.90).gifMessageQueueAccessRightsGibt eine Gruppe von objektspezifischen Zugriffsrechten für Operationen an, die spezifisch für Message Queuing sind.
xes6983c.pubenumeration(de-de,VS.90).gifMessageQueueErrorCodeBezeichnet die Quelle eines Fehlers, der in der Message Queuing-Anwendung aufgetreten ist und eine MessageQueueException-Ausnahme generiert hat.
xes6983c.pubenumeration(de-de,VS.90).gifMessageQueuePermissionAccessDefiniert Zugriffsebenen, die von System.Messaging-Berechtigungsklassen verwendet werden.
xes6983c.pubenumeration(de-de,VS.90).gifMessageQueueTransactionStatusGibt den Zustand einer internen Message Queuing-Transaktion an.
xes6983c.pubenumeration(de-de,VS.90).gifMessageQueueTransactionTypeGibt den Typ einer Message Queuing-Transaktion an.
xes6983c.pubenumeration(de-de,VS.90).gifMessageTypeGibt den Typ einer Meldung an. Eine Meldung kann eine typische Message Queuing-Meldung, eine positive bzw. Eingangs- und Lesebestätigung oder eine Berichtsmeldung sein.
xes6983c.pubenumeration(de-de,VS.90).gifPeekActionGibt an, ob die aktuelle oder die folgende Meldung in der Warteschlange eingesehen werden soll.
xes6983c.pubenumeration(de-de,VS.90).gifQueueAccessModeGibt den Zugriffsmodus für eine MessageQueue zur Erstellungszeit an.
xes6983c.pubenumeration(de-de,VS.90).gifStandardAccessRightsGibt einen Satz von Standardzugriffsrechten an, die Operationen entsprechen, die den meisten Typen von sicherungsfähigen Objekten gemeinsam sind.
xes6983c.pubenumeration(de-de,VS.90).gifTrusteeTypeGibt den Typ eines Vertrauensnehmers an.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft