Message.CreateBufferedCopy(Int32) Method

Reference

Definition

Namespace:: System.ServiceModel.Channels

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Package:: System.ServiceModel.Primitives v6.0.0

Package:: System.ServiceModel.Primitives v6.2.0

Package:: System.ServiceModel.Primitives v8.0.0

Source:: Message.cs

Source:: Message.cs

Source:: Message.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Stores an entire Message into a memory buffer for future access.

public:
 System::ServiceModel::Channels::MessageBuffer ^ CreateBufferedCopy(int maxBufferSize);

public System.ServiceModel.Channels.MessageBuffer CreateBufferedCopy (int maxBufferSize);

member this.CreateBufferedCopy : int -> System.ServiceModel.Channels.MessageBuffer

Public Function CreateBufferedCopy (maxBufferSize As Integer) As MessageBuffer

Parameters

maxBufferSize: Int32

The maximum size of the buffer to be created.

Returns

MessageBuffer

A newly created MessageBuffer object.

Exceptions

ArgumentOutOfRangeException

maxBufferSize is smaller than zero.

ObjectDisposedException

The message is closed.

InvalidOperationException

The message has been copied, read or written.

Remarks

The body of a Message instance can only be accessed or written once. If you want to access a Message instance more than once, you should use the MessageBuffer class to completely store an entire Message instance into memory. A MessageBuffer instance is constructed by calling CreateBufferedCopy of a Message instance.

Note

If Version is equal to None, this method only stores the body of the message, not the entire message into the memory buffer.

Applies to