Message.Extension Proprietà

Definizione

Ottiene o imposta informazioni aggiuntive definite dall'applicazione, associate al messaggio.Gets or sets additional, application-defined information associated with the message.

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; }
member this.Extension : byte[] with get, set
Public Property Extension As Byte()

Valore della proprietà

Byte[]

Matrice di byte che fornisce informazioni aggiuntive, definite dall'applicazione e associate al messaggio.An array of byte values that provides application-defined information associated with the message. L'impostazione predefinita è una matrice di lunghezza zero.The default is a zero-length array.

Attributi

Eccezioni

La coda di messaggi viene filtrata in modo che venga ignorata la proprietà Extension.The message queue is filtered to ignore the Extension property.

La proprietà Extension è null.The Extension property is null.

Commenti

La Extension proprietà fornisce le informazioni definite dall'applicazione, ad esempio un oggetto binario di grandi dimensioni, associato al messaggio.The Extension property provides for application-defined information, like a large binary object, that is associated with the message. È responsabilità dell'applicazione ricevente interpretare il contenuto della Extension proprietà.It is the responsibility of the receiving application to interpret the contents of the Extension property.

Laddove possibile, è necessario includere i dati del messaggio Body nella proprietà del messaggio anziché nella Extension proprietà.Where possible, you should include message data in the Body property of the message rather than the Extension property.

Quando si utilizzano le code esterne, utilizzare la Extension proprietà per specificare le proprietà del messaggio che non esistono in Accodamento messaggi.When working with foreign queues, use the Extension property to specify message properties that do not exist in Message Queuing.

Una coda esterna è presente in un sistema di accodamento diverso da Microsoft Message Queuing.A foreign queue exists in a queuing system other than Microsoft Message Queuing. Accodamento messaggi comunica con tali code tramite un'applicazione connettore.Message Queuing communicates with such queues through a connector application.

Si applica a

Vedi anche