Message.Extension 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.
Obtém ou define informações adicionais definidas pelo aplicativo associadas à mensagem.
public:
property cli::array <System::Byte> ^ Extension { cli::array <System::Byte> ^ get(); void set(cli::array <System::Byte> ^ value); };
[System.Messaging.MessagingDescription("MsgExtension")]
public byte[] Extension { get; set; }
[<System.Messaging.MessagingDescription("MsgExtension")>]
member this.Extension : byte[] with get, set
Public Property Extension As Byte()
Valor da propriedade
Uma matriz de valores de bytes que fornece informações definidas pelo aplicativo associadas à mensagem. O padrão é uma matriz de comprimento zero.
- Atributos
Exceções
A fila de mensagens é filtrada para ignorar a propriedade Extension.
A propriedade Extension é null
.
Comentários
A Extension propriedade fornece informações definidas pelo aplicativo, como um objeto binário grande, que está associado à mensagem. É responsabilidade do aplicativo receptor interpretar o conteúdo da Extension propriedade.
Sempre que possível, você deve incluir dados de mensagem na Body propriedade da mensagem em vez da Extension propriedade .
Ao trabalhar com filas estrangeiras, use a Extension propriedade para especificar propriedades de mensagem que não existem no Enfileiramento de Mensagens.
Existe uma fila estrangeira em um sistema de enfileiramento diferente do Enfileiramento de Mensagens da Microsoft. O Enfileiramento de Mensagens se comunica com essas filas por meio de um aplicativo conector.