BasicHttpBinding.MaxReceivedMessageSize Propiedad

Definición

Obtiene o establece el tamaño máximo, en bytes, de un mensaje que se puede recibir en un canal configurado con este enlace.Gets or sets the maximum size, in bytes, for a message that can be received on a channel configured with this binding.

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 propiedad

Int64

El tamaño máximo, en bytes, de un mensaje que procesa el enlace.The maximum size, in bytes, for a message that is processed by the binding. El valor predeterminado es 65.536 bytes.The default value is 65,536 bytes.

Excepciones

El valor es menor que cero.The value is less than zero.

Ejemplos

En el ejemplo siguiente se establece MaxReceivedMessageSize en 1 millón bytes.The following example sets MaxReceivedMessageSize to 1,000,000 bytes.

BasicHttpBinding binding = new BasicHttpBinding();

// Use double the default value
binding.MaxReceivedMessageSize = 65536 * 2;

El valor de esta propiedad también puede establecerse en el archivo de configuración.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>

Comentarios

El tamaño de los mensajes que se pueden recibir en la conexión por parte de los servicios que usan BasicHttpBinding está limitado por la cantidad de memoria asignada para cada mensaje.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. Este límite en el tamaño del mensaje es para limitar la exposición a ataques de estilo de DoS.This bound on message size is intended to limit exposure to DoS-style attacks.

También hay una propiedad MaxBufferSize en BasicHttpBinding:There is also a MaxBufferSize property on the BasicHttpBinding:

Para transportes almacenados en búfer (TransferMode establecido como Buffered).For buffered transports, (TransferMode set to Buffered). Este valor siempre es igual al especificado por MaxReceivedMessageSize.This value is always equal to that specified by the MaxReceivedMessageSize.

Para transportes transmitidos, (TransferMode establecido como Streamed) sólo se deben almacenar en búfer los encabezados SOAP para generar el mensaje.For streamed transports (TransferMode set to Streamed), only the SOAP headers must be buffered to generate the message. El cuerpo se puede transmitir a petición.The body can be streamed in on-demand. En este caso, MaxBufferSize es menor o igual que maxreceivedmessagesize, donde maxreceivedmessagesize limita el tamaño del mensaje total (encabezados y cuerpo) y MaxBufferSize limita el tamaño de los encabezados SOAP.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.

Se aplica a