XmlMessageFormatter.TargetTypeNames Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica el conjunto de tipos posibles que el formateador deserializará a partir del mensaje proporcionado.
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()Valor de propiedad
Matriz de tipo String que especifica los tipos de objetos que se van a deserializar del cuerpo del mensaje cuando se lea el mensaje.
- Atributos
Excepciones
La propiedad TargetTypeNames es null.
Comentarios
Tanto las TargetTypeNames propiedades como TargetTypes indican al formateador qué esquemas deben intentar coincidir al deserializar un mensaje. Esto permite al formateador interpretar el cuerpo del mensaje.
La instancia serializada en el cuerpo del mensaje debe cumplir uno de los esquemas representados en la matriz de tipos. Al leer el mensaje mediante el Receive método , el método crea un objeto del tipo que corresponde al esquema identificado y lee el cuerpo del mensaje en él.
Solo se debe establecer una de las dos propiedades al leer desde la cola, pero puede establecer ambas. El conjunto de tipos es el conjunto combinado de las dos propiedades. La decisión de qué propiedad usar es específica de la aplicación. Si el cuerpo del mensaje contiene un tipo cuyo esquema no coincide con ninguno de los tipos de la matriz para cualquiera de las propiedades, se producirá una excepción cuando se lea el mensaje.
TargetTypeNames requiere que todas las entradas estén completas, especificando su nombre de ensamblado. Además, al trabajar con varias versiones simultáneas, el número de versión también debe anexarse al nombre del tipo de destino.
Los tipos de destino solo son necesarios al leer de la cola. No es necesario establecer las TargetTypeNames propiedades y TargetTypes para escribir en la cola.
