Message.CreateBufferedCopy Method (Int32)

 

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

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

Public Function CreateBufferedCopy (
	maxBufferSize As Integer
) As MessageBuffer

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.

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.

System_CAPS_noteNote

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

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