BasicHttpBinding.MaxReceivedMessageSize Eigenschaft
Definition
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, setPublic Property MaxReceivedMessageSize As LongEigenschaftswert
Die maximale Größe (in Byte) für eine Meldung, die von der Bindung verarbeitet wird. Der Standardwert ist 65.536 Bytes.
Ausnahmen
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 über die Dienste mit dem BasicHttpBinding empfangen werden können, wird durch die Für jede Nachricht zugewiesene Speichermenge gebunden. 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, der durch die 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 Textkörper) gebunden und MaxBufferSize die Größe der SOAP-Header gebunden.