MessageEncoder.WriteMessage Метод

Определение

Пространство имен:

System.ServiceModel.Channels

Сборка:

System.ServiceModel.Primitives.dll

Пакет:

System.ServiceModel.Primitives v8.0.0

При переопределении в производном классе записывает сообщение в указанный поток или буфер.

Перегрузки

WriteMessage(Message, Stream)	При переопределении в производном классе записывает сообщение в указанный поток.
WriteMessage(Message, Int32, BufferManager)	Записывает сообщение меньше определенного размера в буфер массива байтов.
WriteMessage(Message, Int32, BufferManager, Int32)	При переопределении в производном классе записывает сообщение меньше определенного размера в буфер массива байтов с заданным смещением.

WriteMessage(Message, Stream)

Исходный код:

MessageEncoder.cs

При переопределении в производном классе записывает сообщение в указанный поток.

public:
 abstract void WriteMessage(System::ServiceModel::Channels::Message ^ message, System::IO::Stream ^ stream);

public abstract void WriteMessage (System.ServiceModel.Channels.Message message, System.IO.Stream stream);

abstract member WriteMessage : System.ServiceModel.Channels.Message * System.IO.Stream -> unit

Public MustOverride Sub WriteMessage (message As Message, stream As Stream)

Параметры

message

Message

Объект Message, который требуется записать в поток stream.

stream

Stream

Объект Stream, в который записывается сообщение message.

Примеры

В следующем примере кода показано, как реализовать метод WriteMessage(Message, Stream).

public override void WriteMessage(Message message, Stream stream)
{
    XmlWriter writer = XmlWriter.Create(stream, this.writerSettings);
    message.WriteMessage(writer);
    writer.Close();
}

WriteMessage(Message, Int32, BufferManager)

Исходный код:

MessageEncoder.cs

Записывает сообщение меньше определенного размера в буфер массива байтов.

public:
 ArraySegment<System::Byte> WriteMessage(System::ServiceModel::Channels::Message ^ message, int maxMessageSize, System::ServiceModel::Channels::BufferManager ^ bufferManager);

public ArraySegment<byte> WriteMessage (System.ServiceModel.Channels.Message message, int maxMessageSize, System.ServiceModel.Channels.BufferManager bufferManager);

member this.WriteMessage : System.ServiceModel.Channels.Message * int * System.ServiceModel.Channels.BufferManager -> ArraySegment<byte>

Public Function WriteMessage (message As Message, maxMessageSize As Integer, bufferManager As BufferManager) As ArraySegment(Of Byte)

Параметры

message

Message

Объект Message, записываемый в буфер сообщений.

maxMessageSize

Int32

Максимальный размер записываемого сообщения.

bufferManager

BufferManager

Объект BufferManager, управляющий буфером, в который записывается сообщение.

Возвращаемое значение

ArraySegment<Byte>

Объект ArraySegment<T> типа byte, предоставляющий буфер, в который сериализуется сообщение.

Комментарии

Этот метод вызывает абстрактный метод WriteMessage(Message, Int32, BufferManager, Int32) со значением messageOffset = 0.

WriteMessage(Message, Int32, BufferManager, Int32)

Исходный код:

MessageEncoder.cs

При переопределении в производном классе записывает сообщение меньше определенного размера в буфер массива байтов с заданным смещением.

public:
 abstract ArraySegment<System::Byte> WriteMessage(System::ServiceModel::Channels::Message ^ message, int maxMessageSize, System::ServiceModel::Channels::BufferManager ^ bufferManager, int messageOffset);

public abstract ArraySegment<byte> WriteMessage (System.ServiceModel.Channels.Message message, int maxMessageSize, System.ServiceModel.Channels.BufferManager bufferManager, int messageOffset);

abstract member WriteMessage : System.ServiceModel.Channels.Message * int * System.ServiceModel.Channels.BufferManager * int -> ArraySegment<byte>

Public MustOverride Function WriteMessage (message As Message, maxMessageSize As Integer, bufferManager As BufferManager, messageOffset As Integer) As ArraySegment(Of Byte)

Параметры

message

Message

Объект Message, записываемый в буфер сообщений.

maxMessageSize

Int32

Максимальный размер записываемого сообщения.

bufferManager

BufferManager

Объект BufferManager, управляющий буфером, в который записывается сообщение.

messageOffset

Int32

Смещение фрагмента, которое начинается с начала массива байтов буфера.

Возвращаемое значение

ArraySegment<Byte>

Объект ArraySegment<T> типа byte, предоставляющий буфер, в который сериализуется сообщение.

Примеры

В следующем примере кода показано, как реализовать метод WriteMessage(Message, Int32, BufferManager, Int32).

public override ArraySegment<byte> WriteMessage(Message message, int maxMessageSize, BufferManager bufferManager, int messageOffset)
{
    MemoryStream stream = new MemoryStream();
    XmlWriter writer = XmlWriter.Create(stream, this.writerSettings);
    message.WriteMessage(writer);
    writer.Close();

    byte[] messageBytes = stream.GetBuffer();
    int messageLength = (int)stream.Position;
    stream.Close();

    int totalLength = messageLength + messageOffset;
    byte[] totalBytes = bufferManager.TakeBuffer(totalLength);
    Array.Copy(messageBytes, 0, totalBytes, messageOffset, messageLength);

    ArraySegment<byte> byteArray = new ArraySegment<byte>(totalBytes, messageOffset, messageLength);
    return byteArray;
}

Комментарии

Данный метод вызывается методом WriteMessage(Message, Int32, BufferManager, Int32).