BasicHttpBinding.MaxReceivedMessageSize Właściwość

Definicja

Przestrzeń nazw:

System.ServiceModel

Zestaw:

System.ServiceModel.dll

Pobiera lub ustawia maksymalny rozmiar w bajtach dla komunikatu, który można odebrać w kanale skonfigurowanym za pomocą tego powiązania.

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

Wartość właściwości

Int64

Maksymalny rozmiar w bajtach komunikatu przetwarzanego przez powiązanie. Wartość domyślna to 65 536 bajtów.

Wyjątki

ArgumentOutOfRangeException

Wartość jest mniejsza niż zero.

Przykłady

Poniższy przykład ustawia parametr MaxReceivedMessageSize na 1 000 000 bajtów.

BasicHttpBinding binding = new BasicHttpBinding();

binding.MaxReceivedMessageSize = 1000000;

Wartość tej właściwości można również ustawić w pliku konfiguracji.

<configuration>
  <system.serviceModel>

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

  </system.serviceModel>

</configuration>

Uwagi

Rozmiar komunikatów, które mogą być odbierane w sieci za pomocą usług przy użyciu metody BasicHttpBinding, jest ograniczony ilością pamięci przydzielonej dla każdego komunikatu. Ta granica rozmiaru wiadomości ma na celu ograniczenie narażenia na ataki typu DoS.

W obiekcie BasicHttpBindingznajduje się również MaxBufferSize właściwość :

W przypadku transportu buforowanego (TransferMode ustaw wartość Buffered). Ta wartość jest zawsze równa określonej przez wartość MaxReceivedMessageSize.

W przypadku transportu przesyłanego strumieniowo (TransferMode ustawionego na Streamed), w celu wygenerowania komunikatu muszą być buforowane tylko nagłówki PROTOKOŁU SOAP. Treść może być przesyłana strumieniowo na żądanie. W tym przypadku MaxBufferSize wartość jest mniejsza lub równa wartości MaxReceivedMessageSize, gdzie MaxReceivedMessageSize wiąże rozmiar ogólnego komunikatu (nagłówki i treść) i MaxBufferSize wiąże rozmiar nagłówków SOAP.