Freigeben über


XmlMessageFormatter.Write-Methode

Serialisiert ein Objekt in den Textkörper der Meldung.

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public Sub Write ( _
    message As Message, _
    obj As Object _
)
'Usage
Dim instance As XmlMessageFormatter
Dim message As Message
Dim obj As Object

instance.Write(message, obj)
public void Write (
    Message message,
    Object obj
)
public:
virtual void Write (
    Message^ message, 
    Object^ obj
) sealed
public final void Write (
    Message message, 
    Object obj
)
public final function Write (
    message : Message, 
    obj : Object
)

Parameter

  • message
    Die Message, deren Body-Eigenschaft das serialisierte Objekt aufnimmt.
  • obj
    Das Object, das in den Meldungstext serialisiert werden soll.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

Der message-Parameter ist NULL (Nothing in Visual Basic).

- oder -

Der obj-Parameter ist NULL (Nothing in Visual Basic).

Hinweise

Beim Lesen aus einer Warteschlange müssen die Zieltypen angegeben werden, beim Schreiben in eine Warteschlange jedoch nicht. Die TargetTypeNames-Eigenschaft oder die TargetTypes-Eigenschaft wird vom Formatierungsprogramm nur für das Deserialisieren einer Meldung verwendet.

Der XmlMessageFormatter verwendet die XmlSerializer-Klasse, die die Elemente definiert, die deserialisiert werden können. Es können nur öffentliche Eigenschaften und öffentliche Felder serialisiert werden. Strukturen, Strukturen mit Arrays und Arrays von Strukturen sind alle serialisierbar, falls sie nicht das Codierungsformat für das SOAP-Protokoll verwenden.

.NET Framework-Sicherheit

  • Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

XmlMessageFormatter-Klasse
XmlMessageFormatter-Member
System.Messaging-Namespace
Read