XmlMessageFormatter.TargetTypeNames Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Property TargetTypeNames As String()Valore della proprietà
Matrice di tipo String che specifica i tipi di oggetti da deserializzare dal corpo del messaggio durante la lettura del messaggio.
- Attributi
Eccezioni
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.
