XmlMessageFormatter.TargetTypeNames Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property TargetTypeNames As String()Valor da propriedade
Uma matriz do tipo String que especifica os tipos de objetos a serem desserializados do corpo da mensagem ao ler a mensagem.
- Atributos
Exceções
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.
