XmlMessageFormatter.Read(Message) Метод

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Считывает содержимое из данного сообщения и создает объект, содержащий десериализованное сообщение.

public:
 virtual System::Object ^ Read(System::Messaging::Message ^ message);

public object Read (System.Messaging.Message message);

abstract member Read : System.Messaging.Message -> obj
override this.Read : System.Messaging.Message -> obj

Public Function Read (message As Message) As Object

Параметры

message

Message

Десериализуемое сообщение Message в XML-формате.

Возвращаемое значение

Object

Десериализованное сообщение.

Реализации

Read(Message)

Исключения

InvalidOperationException

Ни свойство TargetTypeNames, ни свойство TargetTypes не установлены.

-или-

Экземпляр, сериализуемый в тело сообщения, не согласуется ни с одной из схем, представленных типами в свойствах TargetTypeNames и TargetTypes.

ArgumentNullException

Параметр message имеет значение null.

Комментарии

TargetTypeNames Свойства и TargetTypes сообщают форматировщику, какие схемы следует пытаться сопоставить при десериализации сообщения. Одно из этих свойств необходимо задать перед десериализацией сообщения.

Экземпляр, сериализованный в тексте сообщения, должен соответствовать одной из схем, представленных в массиве типов. При чтении сообщения с помощью Receive метода метод создает объект типа, соответствующий определенной схеме, и считывает в него текст сообщения.

Для записи в очередь не нужно указывать целевые типы.

См. также раздел

• CanRead(Message)
• Write(Message, Object)
• TargetTypeNames
• TargetTypes
• Message