This topic has not yet been rated - Rate this topic

Message.CreateBufferedCopy Method

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.
ExceptionCondition
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.

NoteNote

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

.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

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.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.