<wsHttpBinding><wsHttpBinding>

Definiert eine sichere, zuverlässige und interoperable Bindung für Nicht-Duplexdienstverträge dar.Defines a secure, reliable, interoperable binding suitable for non-duplex service contracts. Die Bindung implementiert die folgenden Spezifikationen: WS-Reliable Messaging für Zuverlässigkeit und WS-Security für Nachrichtensicherheit und Authentifizierung.The binding implements the following specifications: WS-Reliable Messaging for reliability, and WS-Security for message security and authentication. Für den Transport wird HTTP verwendet und für die Nachrichtencodierung Text/XML-Codierung.The transport is HTTP, and message encoding is Text/XML encoding.

<System. ServiceModel ><system.ServiceModel>
<Bindungen ><bindings>
<WsHttpBinding ><wsHttpBinding>

SyntaxSyntax

<wsHttpBinding>  
    <binding   
        allowCookies="Boolean"  
        bypassProxyOnLocal="Boolean"  
        closeTimeout="TimeSpan"  
        hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
        maxBufferPoolSize="integer"  
        maxReceivedMessageSize="Integer"  
        messageEncoding="Text/Mtom"   
                name="string"  
        openTimeout="TimeSpan"   
        proxyAddress="URI"  
        receiveTimeout="TimeSpan"  
        sendTimeout="TimeSpan"  
                textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
        transactionFlow="Boolean"  
        useDefaultWebProxy="Boolean">  
        <reliableSession ordered="Boolean"  
           inactivityTimeout="TimeSpan"  
           enabled="Boolean" />  
        <security mode="Message/None/Transport/TransportWithCredential">  
           <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
                proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
                realm="string" />  
          <message   
             algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
                          clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"  
             establishSecurityContext="Boolean"  
             negotiateServiceCredential="Boolean" />  
        </security>  
       <readerQuotas             maxArrayLength="Integer"            maxBytesPerRead="Integer"            maxDepth="Integer"             maxNameTableCharCount="Integer"                     maxStringContentLength="Integer" />  
    </binding>  
</wsHttpBinding>  

Attribute und ElementeAttributes and Elements

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.The following sections describe attributes, child elements, and parent elements

AttributeAttributes

AttributAttribute BeschreibungDescription
allowCookiesallowCookies Ein boolescher Wert, der angibt, ob der Client Cookies akzeptiert und für zukünftige Anfragen propagiert.A Boolean value that indicates whether the client accepts cookies and propagates them on future requests. Der Standardwert ist false.The default is false.

Sie können diese Eigenschaft verwenden, wenn Sie mit ASMX-Webdiensten interagieren, die Cookies verwenden.You can use this property when you interact with ASMX Web services that use cookies. 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.In this way, you can be sure that the cookies returned from the server are automatically copied to all future client requests for that service.
bypassProxyOnLocalbypassProxyOnLocal Ein boolescher Wert, der angibt, ob der Proxyserver bei lokalen Adressen umgangen werden soll.A Boolean value that indicates whether to bypass the proxy server for local addresses. Die Standardeinstellung ist false.The default is false.
closeTimeoutcloseTimeout Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Schließvorgangs angibt.A TimeSpan value that specifies the interval of time provided for a close operation to complete. Dieser Wert muss größer oder gleich Zero sein.This value should be greater than or equal to Zero. Der Standardwert ist 00:01:00.The default is 00:01:00.
hostnameComparisonModehostnameComparisonMode Gibt den HTTP-Hostnamen-Vergleichsmodus an, der verwendet wird, um URIs zu analysieren.Specifies the HTTP hostname comparison mode used to parse URIs. Dieses Attribut ist vom Typ HostNameComparisonMode und gibt an, ob beim Abgleich des URI der Hostname zum Erreichen des Dienstes verwendet wird.This attribute is of type HostNameComparisonMode, which indicates whether the hostname is used to reach the service when matching on the URI. Der Standardwert lautet StrongWildcard, wodurch der Hostname beim Abgleich ignoriert wird.The default value is StrongWildcard, which ignores the hostname in the match.
maxBufferPoolSizemaxBufferPoolSize Eine ganze Zahl, die die maximale Pufferpoolgröße für diese Bindung angibt.An integer that specifies the maximum buffer pool size for this binding. Der Standardwert ist 524.288 Byte (512 * 1024).The default is 524,288 bytes (512 * 1024). Viele Teile von Windows Communication Foundation (WCF) verwenden Puffer.Many parts of Windows Communication Foundation (WCF) use buffers. Das Erstellen und Zerstören von Puffern bei jeder Verwendung ist kostspielig. Dasselbe gilt für die Garbage Collection für Puffer.Creating and destroying buffers each time they are used is expensive, and garbage collection for buffers is also expensive. Bei Pufferpools können Sie einen zu verwendenden Puffer aus dem Pool nehmen und ihn nach der Verwendung wieder dem Pool zuführen.With buffer pools, you can take a buffer from the pool, use it, and return it to the pool once you are done. So wird der Aufwand beim Erstellen und Zerstören von Puffern vermieden.Thus the overhead in creating and destroying buffers is avoided.
maxReceivedMessageSizemaxReceivedMessageSize 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.A positive integer that specifies the maximum message size, in bytes, including headers, that can be received on a channel configured with this binding. Der Absender einer Nachricht, die diese Grenze überschreitet, erhält einen SOAP-Fehler.The sender of a message exceeding this limit will receive a SOAP fault. Der Empfänger verwirft die Nachricht und erstellt einen Eintrag des Ereignisses im Ablaufverfolgungsprotokoll.The receiver drops the message and creates an entry of the event in the trace log. Der Standard ist 65536.The default is 65536.
messageEncodingmessageEncoding Definiert den Encoder, der verwendet wird, um die SOAP-Nachricht zu codieren.Defines the encoder used to encode the message. Folgende Werte sind gültig:Valid values include the following:

-Text: Verwenden Sie einen textnachrichtenencoder.- Text: Use a text message encoder.
-Mtom: Verwendung eines Encoders Message Transmission Organisation Mechanism 1.0 (MTOM).- Mtom: Use a Message Transmission Organization Mechanism 1.0 (MTOM) encoder.
– Der Standardwert ist Text.- The default is Text.

Dieses Attribut ist vom Typ WSMessageEncoding.This attribute is of type WSMessageEncoding.
Namename Eine Zeichenfolge, die den Konfigurationsnamen der Bindung enthält.A string that contains the configuration name of the binding. Dieser Wert sollte eindeutig sein, da er von der Bindung zur Identifizierung verwendet wird.This value should be unique because it is used as an identification for the binding. Ab .NET Framework 4.NET Framework 4 müssen Bindungen und Verhalten keinen Namen aufweisen.Starting with .NET Framework 4.NET Framework 4, bindings and behaviors are not required to have a name. Weitere Informationen zur Standardkonfiguration und namenlos Bindungen und Verhaltensweisen finden Sie unter vereinfachte Konfiguration und vereinfachte Konfiguration für WCF-Dienste.For more information about default configuration and nameless bindings and behaviors, see Simplified Configuration and Simplified Configuration for WCF Services.
openTimeoutopenTimeout Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Öffnungsvorgangs angibt.A TimeSpan value that specifies the interval of time provided for an open operation to complete. Dieser Wert muss größer oder gleich Zero sein.This value should be greater than or equal to Zero. Der Standardwert ist 00:01:00.The default is 00:01:00.
proxyAddressproxyAddress Ein URI, der die Adresse des HTTP-Proxys angibt.A URI that specifies the address of the HTTP proxy. Wenn useSystemWebProxy true ist, muss diese Einstellung null lauten.If useSystemWebProxy is true, this setting must be null. Die Standardeinstellung ist null.The default is null.
receiveTimeoutreceiveTimeout Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Empfangsvorgangs angibt.A TimeSpan value that specifies the interval of time provided for a receive operation to complete. Dieser Wert muss größer oder gleich Zero sein.This value should be greater than or equal to Zero. Der Standardwert ist 00:01:00.The default is 00:01:00.
sendTimeoutsendTimeout Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Sendevorgangs angibt.A TimeSpan value that specifies the interval of time provided for a send operation to complete. Dieser Wert muss größer oder gleich Zero sein.This value should be greater than or equal to Zero. Der Standardwert ist 00:01:00.The default is 00:01:00.
textEncodingtextEncoding Gibt die Zeichensatzcodierung an, die zum Ausgeben von Nachrichten über die Bindung verwendet werden soll.Specifies the character set encoding to be used for emitting messages on the binding. Folgende Werte sind gültig:Valid values include the following:

-UnicodeFffeTextEncoding: Unicode BigEndian-Codierung.- UnicodeFffeTextEncoding: Unicode BigEndian encoding.
-Utf16TextEncoding: 16-Bit-Codierung.- Utf16TextEncoding: 16-bit encoding.
-Utf8TextEncoding: 8-Bit-Codierung.- Utf8TextEncoding: 8-bit encoding.

Der Standardwert ist Utf8TextEncoding.The default is Utf8TextEncoding.

Dieses Attribut ist vom Typ Encoding.This attribute is of type Encoding.
transactionFlowtransactionFlow Ein boolescher Wert, der angibt, ob die Bindung geleitete WS-Transaktionen unterstützt.A Boolean value that specifies whether the binding supports flowing WS-Transactions. Die Standardeinstellung ist false.The default is false.
useDefaultWebProxyuseDefaultWebProxy Ein boolescher Wert, der angibt, ob der automatisch konfigurierte HTTP-Proxy des Systems verwendet wird.A Boolean value that specifies whether the system’s auto-configured HTTP proxy is used. Die Standardeinstellung ist true.The default is true.

Untergeordnete ElementeChild Elements

ElementElement BeschreibungDescription
<Sicherheit ><security> Definiert die Sicherheitseinstellungen für die Bindung.Defines the security settings for the binding. Dieses Element ist vom Typ WSHttpSecurityElement.This element is of type WSHttpSecurityElement.
<ReaderQuotas ><readerQuotas> Definiert die Beschränkungen der Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert wurden.Defines the constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement.This element is of type XmlDictionaryReaderQuotasElement.
reliableSessionreliableSession Gibt an, ob zuverlässige Sitzungen zwischen Kanalendpunkten aufgebaut werden.Specifies if reliable sessions are established between channel endpoints.

Übergeordnete ElementeParent Elements

ElementElement BeschreibungDescription
<Bindungen ><bindings> Dieses Element enthält eine Auflistung von standardmäßigen und benutzerdefinierten Bindungen.This element holds a collection of standard and custom bindings.

HinweiseRemarks

Die WSHttpBinding ist der BasicHttpBinding ähnlich, stellt jedoch mehr Webdienstfunktionen bereit.The WSHttpBinding is similar to the BasicHttpBinding but provides more Web service features. Sie verwendet wie BasicHttpBinding den HTTP-Transport und stellt Nachrichtensicherheit bereit, bietet jedoch darüber hinaus Transaktionen, zuverlässiges Messaging und WS-Adressierung, entweder standardmäßig aktiviert oder über ein einziges Steuerelement verfügbar.It uses the HTTP transport and provides message security, as does BasicHttpBinding, but it also provides transactions, reliable messaging, and WS-Addressing, either enabled by default or available through a single control setting.

BeispielExample

<configuration>  
    <system.ServiceModel>  
        <bindings>  
            <wsHttpBinding>  
                <binding   
                    closeTimeout="00:00:10"  
                    openTimeout="00:00:20"   
                    receiveTimeout="00:00:30"  
                    sendTimeout="00:00:40"  
                    bypassProxyOnLocal="false"  
                    transactionFlow="false"   
                    hostNameComparisonMode="WeakWildcard"  
                    maxReceivedMessageSize="1000"  
                    messageEncoding="Mtom"   
                    proxyAddress="http://foo/bar"  
                    textEncoding="utf-16"  
                    useDefaultWebProxy="false">  
                    <reliableSession ordered="false"  
                         inactivityTimeout="00:02:00"  
                         enabled="true" />  
                    <security mode="Transport">  
                         <transport clientCredentialType="Digest"  
                            proxyCredentialType="None"  
                            realm="someRealm" />  
                         <message clientCredentialType="Windows"  
                            negotiateServiceCredential="false"  
                            algorithmSuite="Aes128"   
                            defaultProtectionLevel="None" />  
                    </security>  
                </binding>  
           </wsHttpBinding>  
        </bindings>  
    </system.ServiceModel>  
</configuration>  

Siehe auchSee Also

WSHttpBinding
WSHttpBindingElement
BindungenBindings
Konfigurieren der vom System bereitgestellten BindungenConfiguring System-Provided Bindings
Verwenden von Bindungen, um Windows Communication Foundation-Dienste und Clients konfigurierenUsing Bindings to Configure Windows Communication Foundation Services and Clients
<Binden von ><binding>