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 Größe in Bytes für eine Nachricht ab, die in einem Kanal empfangen werden kann, der mit dieser Bindung konfiguriert ist, 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 Nachricht, die von der Bindung verarbeitet wird. Der Standardwert ist 65.536 Bytes.
Ausnahmen
Der Wert ist kleiner als Null.
Beispiele
Im folgenden Beispiel wird "MaxReceivedMessageSize" auf 1.000.000 Byte 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 Dienste über das BasicHttpBinding auf dem Draht empfangen werden können, ist an die Menge des für jede Nachricht zugewiesenen Arbeitsspeichers gebunden. Diese gebundene Nachrichtengröße soll die Gefährdung von DoS-Angriffen einschränken.
Es gibt auch eine MaxBufferSize Eigenschaft auf der BasicHttpBinding:
Für gepufferte Transporte (TransferMode auf Buffered). Dieser Wert ist immer gleich dem wert, der durch die MaxReceivedMessageSize angegeben wird.
Für gestreamte Transporte (TransferMode festgelegt auf Streamed) müssen nur die SOAP-Header gepuffert werden, um die Nachricht zu generieren. Der Textkörper kann bei Bedarf gestreamt werden. In diesem Fall MaxBufferSize ist maxReceivedMessageSize kleiner oder gleich, wobei MaxReceivedMessageSize die Größe der gesamten Nachricht (Kopfzeilen und Textkörper) begrenzt und MaxBufferSize die Größe der SOAP-Kopfzeilen begrenzt.