XmlMessageFormatter.TargetTypeNames Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica o conjunto de tipos possíveis que serão desserializados pelo formatador a partir 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, setPublic Property TargetTypeNames As String()Valor de Propriedade
Um array de tipo String que especifica os tipos de objetos a desserializar do corpo da mensagem ao ler a mensagem.
- Atributos
Exceções
A propriedade TargetTypeNames é null.
Observações
Tanto as TargetTypeNames propriedades e TargetTypes indicam ao formatador quais os esquemas a tentar corresponder ao desserializar uma mensagem. Isto permite que o formatador interprete o corpo da mensagem.
A instância serializada no corpo da mensagem deve cumprir um dos esquemas representados no array de tipos. Quando 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 de ser definida ao ler da fila, mas pode definir ambas. O conjunto dos tipos é o conjunto combinado das duas propriedades. A decisão sobre qual propriedade usar é específica para a sua candidatura. Se o corpo da mensagem contiver um tipo cujo esquema não corresponde a nenhum dos tipos do array para qualquer uma das propriedades, será lançada uma exceção quando a mensagem for lida.
TargetTypeNames exige que cada entrada seja totalmente qualificada, especificando o nome da sua assembleia. Além disso, ao trabalhar com múltiplas versões simultâneas, o número de versão também deve ser adicionado ao nome do tipo de destino.
Os tipos de alvo só são necessários ao ler da fila. As TargetTypeNames propriedades e TargetTypes não precisam de ser definidas para escrever na fila.
