This topic has not yet been rated - Rate this topic

Message.CreateBufferedCopy Method

.NET Framework 4.5

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

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

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.

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.

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET for Windows Store apps

Supported in: Windows 8

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Message Class

System.ServiceModel.Channels Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)