BasicHttpBinding.MaxReceivedMessageSize Propriedade

Definição

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.dll

Obtém ou define o tamanho máximo, em bytes, para uma mensagem que pode ser recebida em um canal configurado com esta associação.

public:
 property long MaxReceivedMessageSize { long get(); void set(long value); };

public long MaxReceivedMessageSize { get; set; }

member this.MaxReceivedMessageSize : int64 with get, set

Public Property MaxReceivedMessageSize As Long

Valor da propriedade

Int64

O tamanho máximo, em bytes, para uma mensagem recebida que é processada pela associação. O valor padrão é 65.536 bytes.

Exceções

ArgumentOutOfRangeException

O valor é menor que zero.

Exemplos

O exemplo a seguir define MaxReceivedMessageSize como 1.000.000 bytes.

BasicHttpBinding binding = new BasicHttpBinding();

binding.MaxReceivedMessageSize = 1000000;

O valor dessa propriedade também pode ser definido no arquivo de configuração.

<configuration>
  <system.serviceModel>

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

  </system.serviceModel>

</configuration>

Comentários

O tamanho das mensagens que podem ser recebidas na transmissão pelos serviços usando o BasicHttpBinding é limitado pela quantidade de memória alocada para cada mensagem. Esse limite no tamanho da mensagem destina-se a limitar a exposição a ataques no estilo DoS.

Há também uma MaxBufferSize propriedade no BasicHttpBinding:

Para transportes em buffer, (TransferMode definido como Buffered). Esse valor é sempre igual ao especificado pelo MaxReceivedMessageSize.

Para transportes transmitidos (TransferMode definido como Streamed), somente os cabeçalhos SOAP devem ser armazenados em buffer para gerar a mensagem. O corpo pode ser transmitido sob demanda. Nesse caso, MaxBufferSize é menor ou igual a MaxReceivedMessageSize, em que MaxReceivedMessageSize limita o tamanho da mensagem geral (cabeçalhos e corpo) e MaxBufferSize limita o tamanho dos cabeçalhos SOAP.