MessageEncoder.WriteMessage Methode

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Nachricht in den angegebenen Stream oder Puffer.

Überlädt

WriteMessage(Message, Stream)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Nachricht in den angegebenen Stream.
WriteMessage(Message, Int32, BufferManager)	Schreibt eine Nachricht, die kleiner ist als die angegebene Größe, in einen Bytearraypuffer.
WriteMessage(Message, Int32, BufferManager, Int32)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Nachricht, die kleiner ist als die angegebene Größe, im angegebenen Offset in einen Bytearraypuffer.

WriteMessage(Message, Stream)

Quelle:

MessageEncoder.cs

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Nachricht in den angegebenen Stream.

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)

Parameter

message

Message

Die Message, die in den stream geschrieben werden soll.

stream

Stream

Das Stream-Objekt, in das die message geschrieben wird.

Beispiele

Im folgenden Codebeispiel wird die Implementierung der WriteMessage(Message, Stream)-Methode veranschaulicht.

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

WriteMessage(Message, Int32, BufferManager)

Quelle:

MessageEncoder.cs

Schreibt eine Nachricht, die kleiner ist als die angegebene Größe, in einen Bytearraypuffer.

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)

Parameter

message

Message

Die in den Nachrichtenpuffer zu schreibende Message.

maxMessageSize

Int32

Die maximal zulässige Nachrichtengröße, die geschrieben werden kann.

bufferManager

BufferManager

Der BufferManager, der den Puffer verwaltet, in den die Nachricht geschrieben wird.

Gibt zurück

ArraySegment<Byte>

Ein ArraySegment<T> vom Typ byte, das den Puffer bereitstellt, in dem die Nachricht serialisiert wird.

Hinweise

Diese Methode ruft die abstrakte Methode WriteMessage(Message, Int32, BufferManager, Int32) mit messageOffset = 0 auf.

WriteMessage(Message, Int32, BufferManager, Int32)

Quelle:

MessageEncoder.cs

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Nachricht, die kleiner ist als die angegebene Größe, im angegebenen Offset in einen Bytearraypuffer.

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)

Parameter

message

Message

Die in den Nachrichtenpuffer zu schreibende Message.

maxMessageSize

Int32

Die maximal zulässige Nachrichtengröße, die geschrieben werden kann.

bufferManager

BufferManager

Der BufferManager, der den Puffer verwaltet, in den die Nachricht geschrieben wird.

messageOffset

Int32

Offset des Segments, das am Start des Bytearrays beginnt, das den Puffer bereitstellt.

Gibt zurück

ArraySegment<Byte>

Ein ArraySegment<T> vom Typ byte, das den Puffer bereitstellt, in dem die Nachricht serialisiert wird.

Beispiele

Im folgenden Codebeispiel wird die Implementierung der WriteMessage(Message, Int32, BufferManager, Int32)-Methode veranschaulicht.

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;
}

Hinweise

Diese Methode wird von WriteMessage(Message, Int32, BufferManager, Int32) aufgerufen.