XmlMessageFormatter.TargetTypeNames Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Messaging
Assembly:
System.Messaging.dll

Specifica l'insieme di tipi possibili che verranno deserializzati tramite il formattatore dal messaggio fornito.

public:
 property cli::array <System::String ^> ^ TargetTypeNames { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };
[System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")]
public string[] TargetTypeNames { get; set; }
[<System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")>]
member this.TargetTypeNames : string[] with get, set
Public Property TargetTypeNames As String()

Valore della proprietà

String[]

Matrice di tipo String che specifica i tipi di oggetti da deserializzare dal corpo del messaggio durante la lettura del messaggio.

Attributi
MessagingDescriptionAttribute

Eccezioni

ArgumentNullException

La proprietà TargetTypeNames è null.

Commenti

Entrambe le TargetTypeNames proprietà e TargetTypes indicano al formattatore quali schemi tentare di trovare una corrispondenza durante la deserializzazione di un messaggio. In questo modo il formattatore può interpretare il corpo del messaggio.

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.

È necessario impostare solo una delle due proprietà durante la lettura dalla coda, ma è possibile impostare entrambe le proprietà. Il set di tipi è il set combinato delle due proprietà. La decisione della proprietà da usare è specifica per l'applicazione. Se il corpo del messaggio contiene un tipo il cui schema non corrisponde ad alcun tipo nella matrice per entrambe le proprietà, viene generata un'eccezione quando il messaggio viene letto.

TargetTypeNames richiede che ogni voce sia completa, specificando il nome dell'assembly. Inoltre, quando si usano più versioni simultanee, anche il numero di versione deve essere aggiunto al nome del tipo di destinazione.

I tipi di destinazione sono necessari solo durante la lettura dalla coda. Le TargetTypeNames proprietà e TargetTypes non devono essere impostate per scrivere nella coda.

Si applica a

Vedi anche