BasicHttpBinding.MaxReceivedMessageSize Propriété

Définition

Espace de noms:

System.ServiceModel

Assembly:

System.ServiceModel.dll

Obtient ou définit la taille maximale (en octets) d'un message qui peut être reçu sur un canal configuré avec cette liaison.

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

Valeur de propriété

Int64

Taille maximale, en octets, d'un message traité par la liaison. La valeur par défaut est de 65 536 octets.

Exceptions

ArgumentOutOfRangeException

La valeur est inférieure à zéro.

Exemples

L’exemple suivant définit MaxReceivedMessageSize sur 1 000 000 octets.

BasicHttpBinding binding = new BasicHttpBinding();

binding.MaxReceivedMessageSize = 1000000;

La valeur de cette propriété peut également être définie dans le fichier de configuration.

<configuration>
  <system.serviceModel>

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

  </system.serviceModel>

</configuration>

Remarques

La taille des messages qui peuvent être reçus sur le réseau par les services utilisant BasicHttpBinding est limitée par la quantité de mémoire allouée pour chaque message. Cette limite de taille des messages a pour but d'atténuer l'exposition aux attaques de type DoS.

Il existe également une propriété MaxBufferSize dans le BasicHttpBinding :

Pour les transports mis en mémoire tampon (TransferMode est défini sur Buffered). Cette valeur est toujours égale à celle spécifiée par maxReceivedMessageSize.

Pour les transports transmis en continu (TransferMode défini sur Streamed), seuls les en-têtes SOAP doivent être mis en mémoire tampon pour générer le message. Le corps peut être transmis en continu sur demande. Dans ce cas, MaxBufferSize est inférieur ou égal à MaxReceivedMessageSize, où MaxReceivedMessageSize limite la taille du message global (en-têtes et corps) et MaxBufferSize limite la taille des en-têtes SOAP.