XmlMessageFormatter.TargetTypeNames Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Messaging
Ensamblado:
System.Messaging.dll

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, set
Public Property TargetTypeNames As String()

Valor de propiedad

String[]

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
MessagingDescriptionAttribute

Excepciones

ArgumentNullException

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.

Se aplica a

Consulte también