Sdílet prostřednictvím


<wsDualHttpBinding>

Definuje zabezpečenou, spolehlivou a interoperabilní vazbu, která je vhodná pro duplexní kontrakty služeb nebo komunikaci prostřednictvím zprostředkovatelů PROTOKOLU SOAP.

<configuration>
  <system.serviceModel>
    <bindings>
      <wsDualHttpBinding>

Syntaxe

<wsDualHttpBinding>
  <binding name="String"
          closeTimeout="TimeSpan"
          openTimeout="TimeSpan"
          receiveTimeout="TimeSpan"
          sendTimeout="TimeSpan"
          bypassProxyOnLocal="Boolean"
          clientBaseAddress="URI"
          transactionFlow="Boolean"
          hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
          maxBufferPoolSize="integer"
          maxReceivedMessageSize="Integer"
          messageEncoding="Text/Mtom"
          proxyAddress="URI"
          textEncoding="Unicode/BigEndianUnicode/UTF8"
          useDefaultWebProxy="Boolean">
    <reliableSession ordered="Boolean"
                     inactivityTimeout="TimeSpan" />
    <security mode="None/Message">
      <message clientCredentialType="None/Windows/UserName/Certificate/CardSpace"
               negotiateServiceCredential="Boolean"
               algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</wsDualHttpBinding>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Attributes

Vlastnost Description
Bypassproxyonlocal Logická hodnota, která označuje, jestli se má proxy server obejít pro místní adresy. Výchozí hodnota je false.
clientBaseAddress Identifikátor URI, který nastaví základní adresu, kterou klient naslouchá zprávám odpovědí ze služby. Pokud je zadána, tato adresa (plus identifikátor PER-channelGUID) se používá k naslouchání. Pokud není zadaná hodnota, základní adresa klienta se vygeneruje určitým způsobem přenosu. Výchozí hodnota je null.
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 useDefaultWebProxy 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 Nastaví kódování znakové sady, které se použije pro generování zpráv ve vazbě. Platné hodnoty zahrnují následující:

- BigEndianUnicode: Kódování Unicode BigEndian.
– Unicode: 16bitové kódování.
- UTF8: 8bitové kódování

Výchozí hodnota je UTF8. 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á označuje, jestli se používá automaticky nakonfigurovaný proxy server HTTP systému. Proxy adresa musí být null (to znamená, že není nastavena), pokud je truetento atribut . Výchozí hodnota je true.

Podřízené prvky

prvek Description
<bezpečnost> Definuje nastavení zabezpečení pro vazbu. Tento prvek je typu WSDualHttpSecurityElement.
<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

Poskytuje WSDualHttpBinding stejnou podporu protokolů webové služby jako WSHttpBindingprotokoly , ale pro použití s duplexní kontrakty. WSDualHttpBinding podporuje pouze zabezpečení protokolu SOAP a vyžaduje spolehlivé zasílání zpráv. Tato vazba vyžaduje, aby klient má veřejný identifikátor URI, který poskytuje koncový bod zpětného volání pro službu. Tento atribut poskytuje clientBaseAddress . Duální vazba zveřejňuje IP adresu klienta službě. Klient by měl používat zabezpečení, aby se zajistilo, že se připojuje pouze ke službám, kterým důvěřuje.

Tuto vazbu lze použít ke spolehlivé komunikaci prostřednictvím jednoho nebo více zprostředkovatelů SOAP.

Ve výchozím nastavení tato vazba generuje zásobník modulu runtime s WS-ReliableMessaging pro spolehlivost, WS-Security pro zabezpečení a ověřování zpráv, HTTP pro doručování zpráv a kódování zpráv Text/XML.

Example

<configuration>
  <system.ServiceModel>
    <bindings>
      <wsDualHttpBinding>
        <binding closeTimeout="00:00:10"
                 openTimeout="00:00:20"
                 receiveTimeout="00:00:30"
                 sendTimeout="00:00:40"
                 bypassProxyOnLocal="false"
                 clientBaseAddress="http://localhost:8001/client/"
                 transactionFlow="true"
                 hostNameComparisonMode="WeakWildcard"
                 maxReceivedMessageSize="1000"
                 messageEncoding="Mtom"
                 proxyAddress="http://foo/bar"
                 textEncoding="utf-16"
                 useDefaultWebProxy="false">
          <reliableSession ordered="false"
                           inactivityTimeout="00:02:00" />
          <security mode="None">
            <message clientCredentialType="None"
                     negotiateServiceCredential="false"
                     algorithmSuite="Aes128" />
          </security>
        </binding>
      </wsDualHttpBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

Viz také