XmlMessageFormatter.TargetTypeNames Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Especifica o conjunto de tipos possíveis que serão desserializados pelo formatador da mensagem fornecida.

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 da propriedade

String[]

Uma matriz do tipo String que especifica os tipos de objetos a serem desserializados do corpo da mensagem ao ler a mensagem.

Atributos

MessagingDescriptionAttribute

Exceções

ArgumentNullException

A propriedade TargetTypeNames é null.

Comentários

TargetTypeNames As propriedades e TargetTypes informam ao formatador quais esquemas tentar corresponder ao desserializar uma mensagem. Isso permite que o formatador interprete o corpo da mensagem.

A instância serializada no corpo da mensagem deve estar em conformidade com um dos esquemas representados na matriz de tipos. Quando você lê a mensagem usando o Receive método , o método cria um objeto do tipo que corresponde ao esquema identificado e lê o corpo da mensagem nele.

Apenas uma das duas propriedades precisa ser definida ao ler da fila, mas você pode definir ambas. O conjunto de tipos é o conjunto combinado das duas propriedades. A decisão de qual propriedade usar é específica para seu aplicativo. Se o corpo da mensagem contiver um tipo cujo esquema não corresponda a nenhum dos tipos na matriz de qualquer propriedade, uma exceção será gerada quando a mensagem for lida.

TargetTypeNames requer que cada entrada seja totalmente qualificada, especificando o nome do assembly. Além disso, ao trabalhar com várias versões simultâneas, o número de versão também deve ser acrescentado ao nome do tipo de destino.

Os tipos de destino só são necessários ao ler da fila. As TargetTypeNames propriedades e TargetTypes não precisam ser definidas para gravar na fila.

Confira também

• TargetTypes
• CanRead(Message)
• XmlMessageFormatter()