Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Definuje zabezpečenou, spolehlivou a interoperabilní vazbu, která je vhodná pro ne duplexní kontrakty služeb. Vazba implementuje následující specifikace: WS-Reliable Messaging pro zajištění spolehlivosti a WS-Security pro zabezpečení a ověřování zpráv. Přenos je HTTP a kódování zpráv je kódování text/XML.
<configuration>
<system.serviceModel>
<bindings>
<wsHttpBinding>
Syntaxe
<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>
Atributy a prvky
Následující části popisují atributy, podřízené prvky a nadřazené prvky.
Attributes
| Vlastnost | Description |
|---|---|
| allowCookies | Logická hodnota, která označuje, jestli klient přijímá soubory cookie a šíří je do budoucích požadavků. Výchozí hodnota je false. Tuto vlastnost můžete použít při interakci s webovými službami ASMX, které používají soubory cookie. Tímto způsobem si můžete být jistí, že soubory cookie vrácené ze serveru se automaticky zkopírují do všech budoucích žádostí klientů o tuto službu. |
| Bypassproxyonlocal | Logická hodnota, která označuje, jestli se má proxy server obejít pro místní adresy. Výchozí hodnota je false. |
| closeTimeout | Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení operace uzavření. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00. |
| Hostnamecomparisonmode | Určuje režim porovnání názvů hostitelů HTTP, který se používá k analýze identifikátorů URI. Tento atribut je typu HostNameComparisonMode, který označuje, zda se název hostitele používá k dosažení služby při porovnávání identifikátoru URI. Výchozí hodnota je StrongWildcard, která ignoruje název hostitele ve shodě. |
| maxBufferPoolSize | Celé číslo, které určuje maximální velikost fondu vyrovnávací paměti pro tuto vazbu. Výchozí hodnota je 524 288 bajtů (512 × 1024). Mnoho částí windows Communication Foundation (WCF) používá vyrovnávací paměti. Vytváření a zničení vyrovnávacích pamětí při každém jejich použití je nákladné a uvolňování paměti pro vyrovnávací paměti je také nákladné. U fondů vyrovnávací paměti můžete po dokončení vzít vyrovnávací paměť z fondu, použít ji a vrátit ji do fondu. Proto se vyhnete režii při vytváření a zničení vyrovnávacích pamětí. |
| maxReceivedMessageSize | Kladné celé číslo, které určuje maximální velikost zprávy v bajtech, včetně hlaviček, které lze přijímat v kanálu nakonfigurované pomocí této vazby. Odesílatel zprávy překračující tento limit obdrží chybu SOAP. Příjemce zprávu zahodí a vytvoří záznam události v protokolu trasování. Výchozí hodnota je 65536. |
| messageEncoding | Definuje kodér použitý ke kódování zprávy. Platné hodnoty zahrnují následující: - Text: Použijte kodér textové zprávy. - Mtom: Použijte kodér MTOM (Message Transmission Organization Mechanism) 1.0 (MTOM). – Výchozí hodnota je Text. Tento atribut je typu WSMessageEncoding. |
| název | Řetězec, který obsahuje název konfigurace vazby. Tato hodnota by měla být jedinečná, protože se používá jako identifikace vazby. Počínaje rozhraním .NET Framework 4 není nutné, aby vazby a chování měly název. Další informace o výchozí konfiguraci a beznázvových vazbách a chování najdete v tématu Zjednodušená konfigurace a zjednodušená konfigurace pro služby WCF. |
| openTimeout | Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení otevřené operace. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00. |
| Proxyaddress | Identifikátor URI, který určuje adresu proxy serveru HTTP. Pokud useSystemWebProxy ano true, toto nastavení musí být null. Výchozí hodnota je null. |
| receiveTimeout | Hodnota TimeSpan , která určuje časový interval určený k dokončení operace příjmu. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00. |
| sendTimeout | Hodnota TimeSpan , která určuje časový interval určený k dokončení operace odeslání. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00. |
| TextEncoding | Určuje kódování znakové sady, které se má použít pro generování zpráv ve vazbě. Platné hodnoty zahrnují následující: – UnicodeFffeTextEncoding: Kódování Unicode BigEndian. - Utf16TextEncoding: 16bitové kódování. - Utf8TextEncoding: 8bitové kódování. Výchozí hodnota je Utf8TextEncoding. Tento atribut je typu Encoding. |
| transactionFlow | Logická hodnota, která určuje, zda vazba podporuje tok WS-Transactions. Výchozí hodnota je false. |
| useDefaultWebProxy | Logická hodnota, která určuje, jestli se používá automaticky nakonfigurovaný proxy server HTTP systému. Výchozí hodnota je true. |
Podřízené prvky
| prvek | Description |
|---|---|
| <bezpečnost> | Definuje nastavení zabezpečení pro vazbu. Tento prvek je typu WSHttpSecurityElement. |
| <readerQuotas> | Definuje omezení složitosti zpráv SOAP, které lze zpracovat koncovými body nakonfigurovanými touto vazbou. Tento prvek je typu XmlDictionaryReaderQuotasElement. |
| <Reliablesession> | Určuje, jestli jsou mezi koncovými body kanálu vytvořeny spolehlivé relace. |
Nadřazené prvky
| prvek | Description |
|---|---|
| <na něčí žádosti> | Tento element obsahuje kolekci standardních a vlastních vazeb. |
Poznámky
Podobá WSHttpBinding se BasicHttpBinding tomu, ale poskytuje více funkcí webové služby. Používá přenos HTTP a poskytuje zabezpečení zpráv, stejně jako BasicHttpBinding, ale také poskytuje transakce, spolehlivé zasílání zpráv a ws-adresování, a to buď ve výchozím nastavení, nebo dostupné prostřednictvím jediného nastavení ovládacího prvku.
Example
<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>
Viz také
Spolupracujte s námi na GitHubu
Zdroj tohoto obsahu najdete na GitHubu, kde můžete také vytvářet a kontrolovat problémy a žádosti o přijetí změn. Další informace najdete v našem průvodci pro přispěvatele.
