BasicHttpBinding.MaxReceivedMessageSize Eigenschaft

Referenz

Definition

Namespace:: System.ServiceModel

Assembly:: System.ServiceModel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die maximale Nachrichtengröße in Byte ab, die in einem Kanal empfangen werden kann, der mit dieser Bindung konfiguriert wurde, oder legt diese fest.

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

Eigenschaftswert

Int64

Die maximale Größe (in Byte) für eine Meldung, die von der Bindung verarbeitet wird. Der Standardwert ist 65.536 Bytes.

Ausnahmen

ArgumentOutOfRangeException

Der Wert ist kleiner als 0 (null).

Beispiele

Im folgenden Beispiel wird MaxReceivedMessageSize auf 1.000.000 Bytes festgelegt.

BasicHttpBinding binding = new BasicHttpBinding();

binding.MaxReceivedMessageSize = 1000000;

Der Wert dieser Eigenschaft kann auch in der Konfigurationsdatei festgelegt werden.

<configuration>
  <system.serviceModel>

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

  </system.serviceModel>

</configuration>

Hinweise

Die Größe der Nachrichten, die von Diensten mit BasicHttpBinding über die Verbindung empfangen werden können, wird durch die Menge des für jede Nachricht zugewiesenen Arbeitsspeichers begrenzt. Auf diese Weise sollen DoS-ähnliche Angriffe möglichst reduziert werden.

Es ist außerdem eine MaxBufferSize-Eigenschaft für die BasicHttpBinding vorhanden:

Für gepufferte Transporte (TransferMode festgelegt auf Buffered). Dieser Wert ist immer gleich dem Wert, der von MaxReceivedMessageSize angegeben wird.

Bei gestreamten Übertragungen (TransferMode auf Streamed festgelegt) müssen nur die SOAP-Header gepuffert werden, um die Nachricht zu erstellen. Der Text kann bei Bedarf gestreamt werden. In diesem Fall MaxBufferSize ist maxReceivedMessageSize kleiner oder gleich, wobei MaxReceivedMessageSize die Größe der Gesamtnachricht (Kopfzeilen und Text) begrenzt und MaxBufferSize die Größe der SOAP-Header begrenzt.

Gilt für: