ActiveXMessageFormatter Klasse

Definition

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.Serializes or deserializes primitive data types and other objects to or from the body of a Message Queuing message, using a format that is compatible with the MSMQ ActiveX Component.

public ref class ActiveXMessageFormatter : ICloneable, System::Messaging::IMessageFormatter
public class ActiveXMessageFormatter : ICloneable, System.Messaging.IMessageFormatter
type ActiveXMessageFormatter = class
    interface IMessageFormatter
    interface ICloneable
Public Class ActiveXMessageFormatter
Implements ICloneable, IMessageFormatter
Vererbung
ActiveXMessageFormatter
Implementiert

Hinweise

Die ActiveXMessageFormatter ist kompatibel mit Nachrichten, die mit Message Queuing com-Komponenten gesendet werden, und ermöglicht Interoperabilität mit Anwendungen, die das MSMQ COM-Steuerelement verwenden.The ActiveXMessageFormatter is compatible with messages sent using Message Queuing COM components, allowing interoperability with applications that use the MSMQ COM control.

Der ActiveXMessageFormatter kann die meisten primitiven und Objekte, die die IPersistStream OLE-Schnittstelle implementieren, serialisieren.The ActiveXMessageFormatter can serialize most primitives, as well as objects that implement the IPersistStream OLE interface. Sie kann denselben Satz von primitiven deserialisieren, erfordert jedoch beim Deserialisieren eines COM-Objekts (z. b. ein mit Visual Basic 6,0 erstelltes Objekt), das implementiert IPersistStream, einen weiteren Aufwand.It can deserialize the same set of primitives, but requires further effort when deserializing a COM object (for example, an object created using Visual Basic 6.0) that implements IPersistStream. Das zu deserialisierende Objekt muss sich im Arbeitsspeicher befinden, indem das Objekt zuerst in eine .NET Framework Anwendung importiert wird.The object to deserialize must be in memory by first importing the object into a .NET Framework application.

Wenn eine Anwendung eine Nachricht mithilfe einer Instanz der MessageQueue -Klasse an die Warteschlange sendet, serialisiert der Formatierer das Objekt in einen Stream und fügt es in den Nachrichtentext ein.When an application sends a message to the queue using an instance of the MessageQueue class, the formatter serializes the object into a stream and inserts it into the message body. Beim Lesen aus einer Warteschlange mit MessageQueueeinem deserialisiert der Formatierer die Nachrichten Daten in die Body -Eigenschaft eines Message.When reading from a queue using a MessageQueue, the formatter deserializes the message data into the Body property of a Message.

Die ActiveX-Serialisierung ist sehr kompakt, wodurch die ActiveXMessageFormatter Verwendung des-Steuer Elements und des MSMQ com-Steuer Elements eine sehr schnelle Serialisierungsmethode ist.ActiveX serialization is very compact, which makes using the ActiveXMessageFormatter and MSMQ COM control a very fast method of serialization.

Konstruktoren

ActiveXMessageFormatter()

Initialisiert eine neue Instanz der ActiveXMessageFormatter-Klasse.Initializes a new instance of the ActiveXMessageFormatter class.

Methoden

CanRead(Message)

Bestimmt, ob das Formatierungsprogramm den Inhalt der Meldung deserialisieren kann.Determines whether the formatter can deserialize the contents of the message.

Clone()

Erstellt eine Instanz der ActiveXMessageFormatter-Klasse, die mit dem aktuellen ActiveXMessageFormatter übereinstimmt.Creates an instance of the ActiveXMessageFormatter class that is identical to the current ActiveXMessageFormatter.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitStreamedObject(Object)

Stellt ein Dienstprogramm für die Serialisierung von COM-Objekten bereit, die IPersistStream implementieren und einen Aufruf von IPersistStreamInit erfordern.Provides a utility to help serialize COM objects that implement IPersistStream and require IPersistStreamInit to be called.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
Read(Message)

Liest den Inhalt aus der angegebenen Meldung und erstellt ein Objekt, das die deserialisierte Meldung enthält.Reads the contents from the given message and creates an object that contains the deserialized message.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
Write(Message, Object)

Serialisiert ein Objekt in den Textkörper der Meldung.Serializes an object into the body of the message.

Gilt für: