XmlMessageFormatter.Read(Message) Metodo

Definizione

Spazio dei nomi:

System.Messaging

Assembly:

System.Messaging.dll

Legge il contenuto del messaggio indicato e crea un oggetto contenente il messaggio deserializzato.

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

Parametri

message

Message

Il Message, in formato XML da deserializzare.

Restituisce

Object

Messaggio deserializzato.

Implementazioni

Read(Message)

Eccezioni

InvalidOperationException

Nessuna delle due proprietà TargetTypeNames e TargetTypes è stata impostata.

-oppure-

L'istanza serializzata nel corpo del messaggio non è conforme ad alcuno degli schemi rappresentati dai tipi nelle proprietà TargetTypeNames e TargetTypes.

ArgumentNullException

Il valore del parametro message è null.

Commenti

Entrambe le TargetTypeNames proprietà e TargetTypes indicano al formattatore gli schemi da tentare di corrispondere durante la deserializzazione di un messaggio. Una di queste proprietà deve essere impostata prima che il messaggio possa essere deserializzato.

L'istanza serializzata nel corpo del messaggio deve essere conforme a uno degli schemi rappresentati nella matrice di tipi. Quando si legge il messaggio usando il Receive metodo, il metodo crea un oggetto del tipo che corrisponde allo schema identificato e legge il corpo del messaggio in esso.

I tipi di destinazione non devono essere specificati per scrivere nella coda.

Vedi anche

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