ActiveXMessageFormatter-Klasse
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.
Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)
Syntax
'Declaration
Public Class ActiveXMessageFormatter
Implements IMessageFormatter, ICloneable
'Usage
Dim instance As ActiveXMessageFormatter
public class ActiveXMessageFormatter : IMessageFormatter, ICloneable
public ref class ActiveXMessageFormatter : IMessageFormatter, ICloneable
public class ActiveXMessageFormatter implements IMessageFormatter, ICloneable
public class ActiveXMessageFormatter implements IMessageFormatter, ICloneable
Hinweise
Der ActiveXMessageFormatter ist kompatibel mit Meldungen, die mit COM-Komponenten von Message Queuing gesendet wurden. Dadurch wird die Interoperabilität mit Anwendungen hergestellt, die das COM-Steuerelement von MSMQ verwenden.
Der ActiveXMessageFormatter kann die meisten primitiven Datentypen sowie Objekte serialisieren, die die IPersistStream-OLE-Schnittstelle implementieren. Dasselbe Set von primitiven Datentypen kann auch deserialisiert werden. Das Deserialisieren eines COM-Objekts (z. B. eines mit Visual Basic 6.0 erstellten Objekts), das IPersistStream implementiert, erfordert jedoch zusätzlichen Aufwand. Das zu deserialisierende Objekt muss sich im Speicher befinden. Dazu muss das Objekt zunächst in eine .NET Framework-Anwendung importiert werden.
Wenn eine Anwendung mithilfe einer Instanz der MessageQueue-Klasse eine Meldung an die Warteschlange sendet, serialisiert das Formatierungsprogramm das Objekt in einen Stream und fügt es in den Meldungstext ein. Wenn beim Lesen einer Warteschlange MessageQueue verwendet wird, deserialisiert das Formatierungsprogramm die Meldungsdaten in die Body-Eigenschaft einer Message.
Die ActiveX-Serialisierung erfolgt auf sehr kompakte Weise. Daher stellt die Verwendung des ActiveXMessageFormatter und des COM-Steuerelements von MSMQ eine sehr schnelle Form der Serialisierung dar.
Vererbungshierarchie
System.Object
System.Messaging.ActiveXMessageFormatter
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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