XmlMessageFormatter.Read(Message) Método

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Lê o conteúdo de determinada mensagem e cria um objeto que contém a mensagem desserializada.

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

Parâmetros

message

Message

O Message, em formato XML, a ser desserializado.

Retornos

Object

A mensagem desserializada.

Implementações

Read(Message)

Exceções

InvalidOperationException

Nenhuma das propriedades TargetTypeNames ou TargetTypes foi definida.

- ou -

A instância serializada no corpo da mensagem não é compatível com nenhum dos esquemas representados pelos tipos nas propriedades TargetTypeNames e TargetTypes.

ArgumentNullException

O parâmetro message é null.

Comentários

TargetTypeNames As propriedades e TargetTypes informam ao formatador quais esquemas tentar corresponder ao desserializar uma mensagem. Uma dessas propriedades deve ser definida antes que a mensagem possa ser desserializada.

A instância serializada no corpo da mensagem deve estar em conformidade com um dos esquemas representados na matriz de tipos. Quando você lê a mensagem usando o Receive método , o método cria um objeto do tipo que corresponde ao esquema identificado e lê o corpo da mensagem nele.

Os tipos de destino não precisam ser especificados para gravar na fila.

Confira também

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