BasicHttpBinding..::.MaxReceivedMessageSize Property
This page is specific to:.NET Framework Version:3.03.5Silverlight 34.0
.NET Framework Class Library
BasicHttpBinding..::.MaxReceivedMessageSize Property

Gets or sets the maximum size for a message that can be received on a channel configured with this binding.

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

'Usage

Dim instance As BasicHttpBinding
Dim value As Long

value = instance.MaxReceivedMessageSize

instance.MaxReceivedMessageSize = value

'Declaration

Public Property MaxReceivedMessageSize As Long

Property Value

Type: System..::.Int64
The maximum size, in bytes, for a message that is processed by the binding. The default value is 65,536 bytes.
Exceptions

ExceptionCondition
ArgumentOutOfRangeException

The value is less than zero.

Remarks

The size of the messages that can be received on the wire by services using the BasicHttpBinding is bounded by the amount of memory allocated for each message. This bound on message size is intended to limit exposure to DoS-style attacks.

There is also a MaxBufferSize property on the BasicHttpBinding:

  • For buffered transports, (TransferMode set to Buffered). This value is always equal to that specified by the MaxReceivedMessageSize.

  • For streamed transports (TransferMode set to Streamed), only the SOAP headers must be buffered to generate the message. The body can be streamed in on-demand. In this case, MaxBufferSize is less than or equal to MaxReceivedMessageSize, where MaxReceivedMessageSize bounds the size of the overall message (headers and body) and MaxBufferSize bounds the size of the SOAP headers.

Examples

The following example sets MaxReceivedMessageSize to 1,000,000 bytes.

            BasicHttpBinding binding = new BasicHttpBinding();
            // Use double the default value
            binding.MaxReceivedMessageSize = 65536 * 2;



The value of this property can also be set in the configuration file.

<configuration>
  <system.serviceModel>

    <bindings>
      <basicHttpBinding>
        <binding name="Binding1"
                 maxReceivedMessageSize = "1000000">
          <security mode="None" />
        </binding>
      </basicHttpBinding>
    </bindings>

  </system.serviceModel>

</configuration>
.NET Framework Security

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0

.NET Compact Framework

Supported in: 3.5
See Also

Reference

© 2009 Microsoft Corporation. All rights reserved.   Terms of Use | Trademarks | Privacy Statement
Page view tracker
Rate the Lightweight library
x
Lightweight builds on ScriptFree (loband) by adding features you've requested: a SearchBox and default code language selection.
Do you like the SearchBox?
Do you like the tabbed code blocks?
How useful is this topic?
Tell us more.
Thanks
x
You're helping to improve MSDN Online.
Feedback
Switch View
Classic
Lightweight Beta
ScriptFree
Switch View