Message.BodyStream Proprietà

Definizione

Ottiene o imposta le informazioni presenti nel corpo del messaggio.Gets or sets the information in the body of the message.

public:
 property System::IO::Stream ^ BodyStream { System::IO::Stream ^ get(); void set(System::IO::Stream ^ value); };
[System.Messaging.MessagingDescription("MsgBodyStream")]
public System.IO.Stream BodyStream { get; set; }
member this.BodyStream : System.IO.Stream with get, set
Public Property BodyStream As Stream

Valore della proprietà

Oggetto Stream che contiene le informazioni serializzate contenute nel Body del messaggio.A Stream that contains the serialized information included in the Body of the message.

Attributi

Eccezioni

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

Commenti

Il corpo di un messaggio può essere costituito da qualsiasi tipo di informazione, ad esempio una stringa, una data, una valuta, un numero, una matrice di byte o qualsiasi oggetto gestito.The body of a message can consist of any type of information - for example, a string, a date, a currency, a number, an array of bytes, or any managed object. Queste informazioni vengono serializzate in un Stream oggetto da passare alla coda.This information is serialized into a Stream to be passed to the queue.

Specificare la Body proprietà o la BodyStream proprietà prima di inviare l' Message oggetto.Specify either the Body property or the BodyStream property before sending the Message object. Se si imposta la Body proprietà, il contenuto viene serializzato BodyStream nella proprietà.If you set the Body property, the contents are serialized into the BodyStream property. Tuttavia, è possibile scegliere di scrivere direttamente BodyStream la proprietà.However, you can choose to write the BodyStream property directly. Questa operazione è utile, ad esempio, quando si desidera aprire una connessione a un file e trasmettere il relativo contenuto come corpo del messaggio.This is useful, for example, when you want to open a connection to a file and stream its contents as the body of your message.

A BodyStream meno che non si scriva il contenuto del messaggio direttamente nella proprietà, impostare la Formatter proprietà prima di inviare il messaggio.Unless you write the contents of the message directly to the BodyStream property, set the Formatter property before you send the message. Quando il Send metodo viene chiamato MessageQueue sull'istanza, il corpo viene serializzato utilizzando Formatter il formattatore contenuto nella proprietà.When the Send method is called on the MessageQueue instance, the body is serialized using the formatter contained in the Formatter property. Se si invia il messaggio senza specificare un valore per la Formatter proprietà, per XmlMessageFormatterimpostazione predefinita il formattatore è.If you send the message without specifying a value for the Formatter property, the formatter defaults to XmlMessageFormatter.

Se si imposta la UseEncryption proprietà su true per il corpo del messaggio, il messaggio verrà crittografato quando viene inviato, non quando si imposta la Body proprietà.If you set the UseEncryption property to true for the body of this message, the message will be encrypted when it is sent, not when you set the Body property. Quindi, la BodyStream proprietà non viene mai crittografata.Therefore, the BodyStream property is never encrypted.

Si applica a

Vedi anche