Freigeben über


XmlMessageFormatter.Read-Methode

Liest den Inhalt aus der angegebenen Meldung und erstellt ein Objekt, das die deserialisierte Meldung enthält.

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

Syntax

'Declaration
Public Function Read ( _
    message As Message _
) As Object
'Usage
Dim instance As XmlMessageFormatter
Dim message As Message
Dim returnValue As Object

returnValue = instance.Read(message)
public Object Read (
    Message message
)
public:
virtual Object^ Read (
    Message^ message
) sealed
public final Object Read (
    Message message
)
public final function Read (
    message : Message
) : Object

Parameter

  • message
    Die zu deserialisierende Message im XML-Format.

Rückgabewert

Die deserialisierte Meldung.

Ausnahmen

Ausnahmetyp Bedingung

InvalidOperationException

Es wurde weder die TargetTypeNames-Eigenschaft noch die TargetTypes-Eigenschaft festgelegt.

- oder -

Die im Meldungstext serialisierte Instanz entspricht keinem der Schemas, die von den Typen in der TargetTypeNames-Eigenschaft und der TargetTypes-Eigenschaft dargestellt werden.

ArgumentNullException

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

Hinweise

Die TargetTypeNames-Eigenschaft und die TargetTypes-Eigenschaft geben an, welche Schemas das Formatierungsprogramm beim Deserialisieren einer Meldung auf Übereinstimmung prüfen soll. Bevor die Meldung deserialisiert werden kann, muss eine dieser Eigenschaften festgelegt werden.

Die im Meldungstext serialisierte Instanz muss einem der im Typarray dargestellten Schemas entsprechen. Wenn Sie die Meldung mit der Receive-Methode lesen, erstellt die Methode ein Objekt des Typs, der dem bezeichneten Schema entspricht, und liest den Meldungstext in dieses Objekt.

Die Zieltypen müssen für das Schreiben in eine Warteschlange nicht festgelegt werden.

.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
CanRead
Write
TargetTypeNames
TargetTypes
Message-Klasse