<webHttpBinding>

Artikel
06/05/2023

Definiert ein Bindungselement, das zum Konfigurieren von Endpunkten für WCF-Webdienste (Windows Communication Foundation) verwendet wird, die auf HTTP-Anforderungen und nicht auf SOAP-Nachrichten reagieren.

<configuration>
  <system.serviceModel>
    <bindings>
      <webHttpBinding>

Syntax

<webHttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxBufferSize="integer"
           maxReceivedMessageSize="Integer"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
           useDefaultWebProxy="Boolean"
           writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding">
    <security mode="None/Transport/TransportCredentialOnly">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</webHttpBinding>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

attribute	BESCHREIBUNG
allowCookies	Ein boolescher Wert, der angibt, ob der Client Cookies akzeptiert und für zukünftige Anfragen propagiert. Die Standardeinstellung ist „false“. Sie können diese Eigenschaft verwenden, wenn Sie mit ASMX-Webdiensten interagieren, die Cookies verwenden. Auf diese Weise können Sie sicherstellen, dass die vom Server zurückgegebenen Cookies automatisch bei allen zukünftigen Clientanforderungen für diesen Dienst kopiert werden.
bypassProxyOnLocal	Ein boolescher Wert, der angibt, ob der Proxyserver bei lokalen Adressen umgangen werden soll. Der Standardwert ist `false`.
closeTimeout	Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Schließvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00.
hostnameComparisonMode	Gibt den HTTP-Hostnamen-Vergleichsmodus an, der verwendet wird, um URIs zu analysieren. Dieses Attribut ist vom Typ HostNameComparisonMode und gibt an, ob beim Abgleich des URI der Hostname zum Erreichen des Dienstes verwendet wird. Der Standardwert lautet StrongWildcard, wodurch der Hostname beim Abgleich ignoriert wird.
maxBufferPoolSize	Eine ganze Zahl, die die maximale Pufferpoolgröße für diese Bindung angibt. Der Standardwert ist 524.288 Byte (512 * 1024). Viele Teile von Windows Communication Foundation (WCF) verwenden Puffer. Das Erstellen und Zerstören von Puffern bei jeder Verwendung ist kostspielig. Dasselbe gilt für die Garbage Collection für Puffer. Bei Pufferpools können Sie einen zu verwendenden Puffer aus dem Pool nehmen und ihn nach der Verwendung wieder dem Pool zuführen. So wird der Aufwand beim Erstellen und Zerstören von Puffern vermieden.
maxBufferSize	Eine ganze Zahl, die die maximale Speicherkapazität der Nachrichtenpuffer angibt, die Nachrichten aus dem Kanal empfangen. Der Standardwert ist 524,288 (0x80000) Bytes.
maxReceivedMessageSize	Eine positive ganze Zahl, die die maximale Nachrichtengröße in Bytes einschließlich Header angibt, die in einem für diese Bindung konfigurierten Kanal beim Nachrichtenempfang zulässig ist. Der Absender einer Nachricht, die diese Grenze überschreitet, erhält einen Fehler. Der Empfänger verwirft die Nachricht und erstellt einen Eintrag des Ereignisses im Ablaufverfolgungsprotokoll. Der Standard ist 65536. Hinweis: Es reicht im ASP.NET-Kompatibilitätsmodus nicht aus, nur diesen Wert zu erhöhen. Sie müssen auch den Wert von `httpRuntime` erhöhen (weitere Informationen finden Sie unter httpRuntime-Element [ASP.NET-Einstellungsschema]).
name	Eine Zeichenfolge, die den Konfigurationsnamen der Bindung enthält. Dieser Wert sollte eindeutig sein, da er von der Bindung zur Identifizierung verwendet wird. Ab .NET Framework 4 müssen Bindungen und Verhaltensweisen keinen Namen aufweisen. Weitere Informationen über Standardkonfiguration und namenlose Bindungen und Verhalten finden Sie unter Simplified Configuration (Vereinfachte Konfiguration) und Simplified Configuration for WCF Services (Vereinfachte Konfiguration für WCF-Dienste).
openTimeout	Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Öffnungsvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00.
proxyAddress	Ein URI, der die Adresse des HTTP-Proxys angibt. Wenn `useSystemWebProxytrue` ist, muss diese Einstellung `null` lauten. Der Standardwert ist `null`.
receiveTimeout	Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Empfangsvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00.
sendTimeout	Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Sendevorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00.
transferMode.	Ein TransferMode-Wert, der angibt, ob der mit der Bindung konfigurierte Dienst Streaming- oder Puffermodi (oder beides) für die Nachrichtenübertragung einsetzt. Der Standardwert ist `Buffered`.
useDefaultWebProxy	Ein boolescher Wert, der angibt, ob der automatisch konfigurierte HTTP-Proxy des Systems verwendet wird. Der Standardwert ist `true`.
writeEncoding	Gibt die Zeichenkodierung an, die für den Nachrichtentext verwendet wird. Gültige Werte sind: UnicodeFffeTextEncoding: Unicode BigEndian-Codierung. Utf16TextEncoding: 16-Bit-Codierung. Utf8TextEncoding: 8-Bit-Codierung. Der Standardwert ist Utf8TextEncoding.

Untergeordnete Elemente

Element	BESCHREIBUNG
<readerQuotas>	Definiert die Beschränkungen der Komplexität von POX-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert wurden. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement.
<security>	Definiert die Sicherheitseinstellungen für die Bindung. Dieses Element ist vom Typ WebHttpSecurityElement.

Übergeordnete Elemente

Element	BESCHREIBUNG
<bindings>	Dieses Element enthält eine Auflistung von standardmäßigen und benutzerdefinierten Bindungen.

Bemerkungen

Das WCF-Webprogrammiermodell ermöglicht Entwicklern, WCF-Webdienste über HTTP-Anforderungen verfügbar zu machen, die POX-Messaging (Plain Old XML) statt SOAP-basiertes Messaging verwenden. Damit Clients mit einem Dienst über HTTP-Anforderungen kommunizieren können, muss ein Endpunkt des Diensts mit der <webHttpBinding> konfiguriert sein, an die <WebHttpBehavior> angefügt ist.

Die WCF-Unterstützung für Syndikation und ASP.AJAX-Integration ist über dem Webprogrammiermodell implementiert. Weitere Informationen zum Modell finden Sie unter WCF-Web-HTTP-Programmiermodell.

Freigeben über