Message::CreateBufferedCopy Method (Int32)

.NET Framework (current version)

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

Namespace: System.ServiceModel.Channels
Assembly: System.ServiceModel (in System.ServiceModel.dll)

Syntax

public:
MessageBuffer^ CreateBufferedCopy(
	int maxBufferSize
)

Parameters

maxBufferSize: Type: System::Int32
The maximum size of the buffer to be created.

Return Value

Type: System.ServiceModel.Channels::MessageBuffer^

A newly created MessageBuffer object.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	maxBufferSize is smaller than zero.
ObjectDisposedException	The message is closed.
InvalidOperationException	The message has been copied, read or written.

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.

Version Information

Universal Windows Platform
Available since 8
.NET Framework
Available since 3.0
Portable Class Library
Supported in: portable .NET platforms