Message.BodyStream Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Pobiera lub ustawia informacje w treści wiadomości.

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; }
[<System.Messaging.MessagingDescription("MsgBodyStream")>]
member this.BodyStream : System.IO.Stream with get, set
Public Property BodyStream As Stream

Wartość właściwości

Stream

Element Stream zawierający serializowane informacje zawarte w Body komunikacie.

Atrybuty
MessagingDescriptionAttribute

Wyjątki

InvalidOperationException

Kolejka komunikatów jest filtrowana w celu zignorowania Body właściwości.

Uwagi

Treść komunikatu może składać się z dowolnego typu informacji — na przykład ciągu, daty, waluty, liczby, tablicy bajtów lub dowolnego zarządzanego obiektu. Te informacje są serializowane w Stream celu przekazania do kolejki.

Body Określ właściwość lub BodyStream właściwość przed wysłaniem Message obiektu. W przypadku ustawienia Body właściwości zawartość jest serializowana we BodyStream właściwości . Można jednak bezpośrednio zapisać BodyStream właściwość. Jest to przydatne, na przykład wtedy, gdy chcesz otworzyć połączenie z plikiem i przesłać strumieniowo jego zawartość jako treść wiadomości.

Jeśli nie napiszesz zawartości wiadomości bezpośrednio do BodyStream właściwości, ustaw Formatter właściwość przed wysłaniem wiadomości. Send Gdy metoda jest wywoływana w wystąpieniuMessageQueue, treść jest serializowana przy użyciu formatnika zawartego Formatter we właściwości. Jeśli wysyłasz komunikat bez określania wartości właściwości Formatter , formater domyślnie ma wartość XmlMessageFormatter.

Jeśli właściwość true zostanie ustawiona UseEncryption na wartość dla treści tego komunikatu, komunikat zostanie zaszyfrowany po wysłaniu, a nie po ustawieniu Body właściwości. W związku z BodyStream tym właściwość nigdy nie jest szyfrowana.

Dotyczy

Zobacz też