Message.BodyStream Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Element Stream zawierający serializowane informacje zawarte w Body komunikacie.
- Atrybuty
Wyjątki
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.