BasicHttpBinding.MaxReceivedMessageSize Propriedade

Definição

Espaço de Nomes:
System.ServiceModel
Assemblagem:
System.ServiceModel.dll

Obtém ou define o tamanho máximo, em bytes, para uma mensagem que pode ser recebida num canal configurado com esta ligaçã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 de Propriedade

Int64

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

Exceções

ArgumentOutOfRangeException

O valor é inferior a zero.

Exemplos

O exemplo seguinte define MaxReceivedMessageSize para 1.000.000 bytes.

BasicHttpBinding binding = new BasicHttpBinding();

binding.MaxReceivedMessageSize = 1000000;

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

<configuration>
  <system.serviceModel>

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

  </system.serviceModel>

</configuration>

Observações

O tamanho das mensagens que podem ser recebidas na ligação por serviços que utilizam o BasicHttpBinding é limitado pela quantidade de memória alocada para cada mensagem. Este limite no tamanho da mensagem destina-se a limitar a exposição a ataques do tipo DoS.

Existe também uma MaxBufferSize propriedade no BasicHttpBinding:

Para transportes em buffer, (TransferMode defina para Buffered). Este valor é sempre igual ao especificado pelo MaxReceivedMessageSize.

Para transportes transmitidos (TransferMode definidos para Streamed), apenas os cabeçalhos SOAP devem ser armazenados em buffer para gerar a mensagem. A carroçaria pode ser transmitida em streaming a pedido. Neste caso, MaxBufferSize é menor ou igual a MaxReceivedMessageSize, onde MaxReceivedMessageSize limita o tamanho total da mensagem (cabeçalhos e corpo) e MaxBufferSize limita o tamanho dos cabeçalhos SOAP.

Aplica-se a