<webHttpBinding>

Artikel
09/12/2008

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

<<system.serviceModel>>
<bindings>
<<wsHttpBinding>>

<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

Attribute

Attribut	Beschreibung
allowCookies	Ein boolescher Wert, der angibt, ob der Client Cookies akzeptiert und für zukünftige Anfragen propagiert. Der Standardwert 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 ist 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) Byte.
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 Standardwert ist 65536. Tipp Es reicht im ASP.NET-Kompatibilitätsmodus nicht aus, nur diesen Wert zu erhöhen. Sie sollten auch den Wert von httpRuntime erhöhen (siehe httpRuntime Element (ASP.NET Settings Schema)).
name	Eine Zeichenfolge, die den Konfigurationsnamen der Bindung enthält. Dieser Wert sollte eindeutig sein, da er von der Bindung zur Identifizierung verwendet wird.
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 useSystemWebProxy true 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. Die Standardeinstellung ist true.
writeEncoding	Gibt die Zeichenkodierung an, die für den Nachrichtentext verwendet wird. Folgende Werte sind gültig: UnicodeFffeTextEncoding: Unicode BigEndian-Codierung. Utf16TextEncoding: 16-Bit-Codierung. Utf8TextEncoding: 8-Bit-Codierung. Der Standard 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> von <webHttpBinding>	Definiert die Sicherheitseinstellungen für die Bindung. Dieses Element ist vom Typ WSHttpSecurityElement.

Übergeordnete Elemente

Element	Beschreibung
<bindings>	Dieses Element enthält eine Auflistung von standardmäßigen und benutzerdefinierten Bindungen. Jeder Eintrag wird durch seinen name identifiziert. Dienste verwenden Bindungen, indem sie sie mithilfe des name verknüpfen.

Hinweise

Das WCF-Webprogrammiermodell ermöglicht es Entwicklern, WCF-Webdienste über HTTP-Anforderungen verfügbar zu machen, die POX-Messaging anstatt von SOAP-basiertem Messaging verwenden. Damit Clients mit einem Dienst über HTTP-Anforderungen kommunizieren können, muss ein Endpunkt des Diensts mit der <<wsHttpBinding>> konfiguriert sein, an die <WebHttpBehavior> angehängt ist.

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

Siehe auch

Referenz

WebHttpBinding
WebHttpBindingElement

Konzepte

Weitere Ressourcen

Web Programming Model
Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients