Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Definiert eine interoperable Bindung, die Unterstützung für die richtigen Versionen der SecurityElemente , ReliableSessionund TransactionFlow Bindungselemente bereitstellt.
<Konfiguration>
<system.serviceModel>
<Einbände>
<ws2007HttpBinding>
Syntax
<ws2007HttpBinding>
<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 clientCredentialType ="Certificate/IssuedToken/None/UserName/Windows"
negotiateServiceCredential="Boolean"
algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
establishSecurityContext="Boolean" />
</security>
<readerQuotas maxArrayLength="Integer"
maxBytesPerRead="Integer"
maxDepth="Integer"
maxNameTableCharCount="Integer"
maxStringContentLength="Integer" />
</binding>
</ws2007HttpBinding>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
| Merkmal | Description |
|---|---|
allowCookies |
Ein Wert, der angibt, ob der Kunde Cookies akzeptiert und an zukünftige Anforderungen weitergibt. Der Standardwert lautet false.Sie können diese Eigenschaft verwenden, wenn Sie mit ASP.NET Webdiensten (ASMX) interagieren, die Cookies verwenden. Dadurch wird sichergestellt, dass Cookies, die der Server zurückgibt, automatisch in alle zukünftigen Clientanforderungen für diesen Dienst kopiert werden. |
bypassProxyOnLocal |
Ein Wert, der angibt, ob der Proxyserver für lokale Adressen umgangen werden soll. Der Standardwert lautet false. |
closeTimeout |
Ein TimeSpan Wert, der das Zeitintervall für einen abschlussden Vorgang angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00. |
hostNameComparisonMode |
Gibt den HTTP-Hostnamen-Vergleichsmodus an, der zum Analysieren von UNIFORM Resource Identifiers (URIs) verwendet wird. Dieses Attribut ist vom Typ HostNameComparisonMode, der angibt, ob der Hostname verwendet wird, um den Dienst beim Abgleich im URI zu erreichen. Der Standardwert ist StrongWildcard, der den Hostnamen in der Übereinstimmung ignoriert. |
maxBufferPoolSize |
Die maximale Pufferpoolgröße für diese Bindung. Der Standardwert ist 524.288 Bytes (512 × 1.024). Viele Teile von Windows Communication Foundation (WCF) verwenden Puffer. Das Erstellen und Zerstören von Puffern jedes Mal, wenn sie verwendet werden, ist teuer, wie die Garbage Collection für Puffer. Mit Pufferpools können Sie einen Puffer aus dem Pool übernehmen, ihn verwenden und nach Abschluss an den Pool zurückgeben. Dadurch wird der Aufwand beim Erstellen und Zerstören von Puffern vermieden. |
maxReceivedMessageSize |
Die maximale Nachrichtengröße in Bytes, einschließlich Kopfzeilen, die ein mit dieser Bindung konfigurierter Kanal empfangen kann. Der Absender einer Nachricht, die diesen Grenzwert überschreitet, empfängt einen SOAP-Fehler. Der Empfänger legt die Nachricht ab und erstellt einen Eintrag des Ereignisses im Ablaufverfolgungsprotokoll. Der Standardwert ist 65536. |
messageEncoding |
Definiert den Encoder, der zum Codieren der Nachricht verwendet wird. Gültige Werte umfassen Folgendes: - Text: Verwenden Sie einen Textnachrichten-Encoder.- Mtom: Verwenden Sie einen Message Transmission Organization Mechanism 1.0 (MTOM)-Encoder.Der Standardwert lautet Text.Dieses Attribut ist vom Typ WSMessageEncoding. |
name |
Der Konfigurationsname der Bindung. Dieser Wert sollte eindeutig sein, da er als Identifikation für die Bindung verwendet wird. Ab .NET Framework 4 müssen Bindungen und Verhaltensweisen keinen Namen haben. Weitere Informationen zu Standardkonfigurationen und namenslosen Bindungen und Verhaltensweisen finden Sie unter Vereinfachte Konfiguration und vereinfachte Konfiguration für WCF-Dienste. |
openTimeout |
Ein TimeSpan Wert, der das Für den Abschluss eines geöffneten Vorgangs bereitgestellte Zeitintervall angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00. |
proxyAddress |
Ein URI, der die Adresse des HTTP-Proxys angibt. Ist useSystemWebProxy dies der Fall true, muss diese Einstellung sein null. Der Standardwert lautet null. |
receiveTimeout |
Ein TimeSpan Wert, der das Für den Abschluss eines Empfangsvorgangs bereitgestellte Zeitintervall angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00. |
sendTimeout |
Ein TimeSpan Wert, der das Für den Abschluss eines Sendevorgangs bereitgestellte Zeitintervall angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00. |
textEncoding |
Gibt die zeichensatzcodierung an, die zum Ausgeben von Nachrichten in der Bindung verwendet werden soll. Gültige Werte umfassen Folgendes: - UnicodeFffeTextEncoding: Unicode Big Endian-Codierung.- Utf16TextEncoding: 16-Bit-Codierung.- Utf8TextEncoding: 8-Bit-Codierung.Der Standardwert lautet Utf8TextEncoding.Dieses Attribut ist vom Typ Encoding. |
transactionFlow |
Ein Wert, der angibt, ob die Bindung den Fluss von WS-Transactions unterstützt. Der Standardwert lautet false. |
useDefaultWebProxy |
Ein Wert, der angibt, ob der automatisch konfigurierte HTTP-Proxy des Systems verwendet wird. Der Standardwert lautet true. |
Untergeordnete Elemente
| Element | Description |
|---|---|
| <Sicherheit> | Definiert die Sicherheitseinstellungen für die Bindung. Dieses Element ist vom Typ WSHttpSecurityElement. |
| <readerQuotas> | Definiert die Einschränkungen für die Komplexität von SOAP-Nachrichten, die endpunkten, die mit dieser Bindung konfiguriert sind. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement. |
| <Reliablesession> | Gibt an, ob zuverlässige Sitzungen zwischen Kanalendpunkten hergestellt werden. |
Übergeordnete Elemente
| Element | Description |
|---|---|
| <Einbände> | Dieses Element enthält eine Sammlung von Standard- und benutzerdefinierten Bindungen. |
Bemerkungen
Das WS2007HttpBinding addiert eine vom System bereitgestellte Bindung ähnlich wie WSHttpBinding die Organisation für die Weiterentwicklung von Structured Information Standards (OASIS) Standardversionen der Protokolle ReliableSession, Security und TransactionFlow. Bei Verwendung dieser Bindung sind keine Änderungen am Objektmodell oder den Standardeinstellungen erforderlich.
Example
<configuration>
<system.ServiceModel>
<bindings>
<ws2007HttpBinding>
<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://www.contoso.com"
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>
</ws2007HttpBinding>
</bindings>
</system.ServiceModel>
</configuration>
Siehe auch
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
