<wsHttpContextBinding>
Gibt einen Kontext für WsHttpBinding an, der voraussetzt, dass die Sicherheitsebene signiert wird.
<<system.serviceModel>>
<bindings>
<wsHttpContextBinding>
<wsHttpContextBinding>
<binding
allowCookies="Boolean"
bypassProxyOnLocal="Boolean"
closeTimeout="TimeSpan"
contextProtectionLevel="EncryptAndSign/None/Sign"
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"
defaultClientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
defaultProxyCredentialType="Basic/Digest/None/Ntlm/Windows"
defaultRealm="string" />
<message clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"
algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
establishSecurityContext="Boolean"
negotiateServiceCredential="Boolean"/>
</security>
<readerQuotas maxDepth="integer"
maxStringContentLength="integer"
maxByteArrayContentLength="integer"
maxBytesPerRead="integer"
maxNameTableCharCount="integer" />
</binding>
</wsHttpContextBinding>
Attribute und Elemente
Attribute
| Attribut | Beschreibung |
|---|---|
allowCookies |
Ein boolescher Wert, der angibt, ob der Client Cookies akzeptiert und bei zukünftigen Anforderungen propagiert. Die Standardeinstellung ist false. Wenn allowCookies auf true festgelegt ist, verwendet contextChannel als Austauschkontextmodus httpCookies. Wenn dieses Attribut auf false festgelegt ist, wird der Kontext über SOAP-Header ausgetauscht. 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 in alle zukünftigen Clientanforderungen für diesen Dienst kopiert werden. |
bypassProxyOnLocal |
Ein boolescher Wert, der angibt, ob der Proxyserver bei lokalen Adressen umgangen werden soll. Die Standardeinstellung 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. Die Standardeinstellung lautet 00:01:00. |
contextProtectionLevel |
Ein gültiger ProtectionLevel-Wert, der die gewünschte Sicherheitsebene des SOAP-Headers angibt, der zum Propagieren der Kontextinformationen verwendet wird. Der Standardwert ist Sign. |
hostnameComparisonMode |
Gibt den zum Analysieren von URIs verwendeten HTTP-Hostnamen-Vergleichsmodus an. Dieses Attribut ist vom Typ HostnameComparisonMode und gibt an, ob beim Abgleich des URI der Hostname zum Erreichen des Diensts 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). In Windows Communication Foundation (WCF) werden Puffer häufig verwendet. Es ist aufwändig, Puffer bei jeder Verwendung zu erstellen und zu löschen, und die Garbage Collection für Puffer ist ebenfalls aufwändig. Bei Pufferpools können Sie einen zu verwendenden Puffer aus dem Pool nehmen und ihn nach der Verwendung wieder dem Pool zuführen. Auf diese Weise wird der mit dem Erstellen und Zerstören von Puffern verbundene Aufwand vermieden. |
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 diesen Grenzwert überschreitet, erhält einen SOAP-Fehler. Der Empfänger legt die Nachricht ab und erstellt im Ablaufverfolgungsprotokoll einen Eintrag zu diesem Ereignis. Der Standardwert ist 65536. |
messageEncoding |
Definiert den Encoder, der verwendet wird, um die SOAP-Nachricht zu kodieren. Gültige Werte sind:
Dieses Attribut ist vom Typ WSMessageEncoding. |
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. Falls useSystemWebProxy auf true festgelegt 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. |
textEncoding |
Gibt die Zeichensatzcodierung an, die zum Ausgeben von Nachrichten über die Bindung verwendet werden soll. Gültige Werte sind:
Der Standard ist Utf8TextEncoding. Dieses Attribut ist vom Typ Encoding. |
transactionFlow |
Ein boolescher Wert, der angibt, ob die Bindung geleitete WS-Transaktionen unterstützt. Die Standardeinstellung ist false. |
useDefaultWebProxy |
Ein boolescher Wert, der angibt, ob der automatisch konfigurierte HTTP-Proxy des Systems verwendet wird. Die Standardeinstellung ist true. |
Untergeordnete Elemente
| Element | Beschreibung |
|---|---|
Definiert die Sicherheitseinstellungen für die Bindung. Dieses Element ist vom Typ WSHttpSecurityElement. |
|
Definiert die Beschränkungen der Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert wurden. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement. |
|
Gibt an, ob zuverlässige Sitzungen zwischen Kanalendpunkten aufgebaut werden. |
Übergeordnete Elemente
| Element | Beschreibung |
|---|---|
Dieses Element enthält eine Auflistung von standardmäßigen und benutzerdefinierten Bindungen. Jeder Eintrag ist durch seinen name gekennzeichnet. Dienste verwenden Bindungen, indem sie sie mithilfe des name verknüpfen. |
Siehe auch
Referenz
<<wsHttpBinding>>
WSHttpBinding
WSHttpContextBinding
wsHttpContextBindingElement
ContextBindingElement
Konzepte
Weitere Ressourcen
Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients