<ws2007HttpBinding>

Článek
07/07/2023

Definuje interoperabilní vazbu, která poskytuje podporu správných verzí elementů Securityvazby , ReliableSessiona TransactionFlow .

<Konfigurace>
  <System.servicemodel>
    <Vazby>
      <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>

Atributy a elementy

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

Atributy

Atribut	Popis
`allowCookies`	Hodnota, která označuje, jestli klient přijímá soubory cookie a šíří je v budoucích požadavcích. Výchozí formát je `false`. Tuto vlastnost můžete použít při interakci s webovými službami ASP.NET (ASMX), které používají soubory cookie. Tím zajistíte, že soubory cookie, které server vrátí, se automaticky zkopírují do všech budoucích požadavků klientů pro danou službu.
`bypassProxyOnLocal`	Hodnota, která označuje, zda se má obejít proxy server pro místní adresy. Výchozí formát je `false`.
`closeTimeout`	Hodnota TimeSpan , která určuje časový interval dokončení operace uzavření. Tato hodnota by měla být větší nebo rovna hodnotě 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 (Uniform Resource Identifier). Tento atribut je typu HostNameComparisonMode, který označuje, jestli se název hostitele používá k připojení ke službě při porovnávání v identifikátoru URI. Výchozí hodnota je StrongWildcard, která ignoruje název hostitele v shodě.
`maxBufferPoolSize`	Maximální velikost fondu vyrovnávací paměti pro tuto vazbu. Výchozí hodnota je 524 288 bajtů (512 × 1 024). Mnoho částí Windows Communication Foundation (WCF) používá vyrovnávací paměti. Vytváření a ničení vyrovnávacích pamětí při každém jejich použití je nákladné, stejně jako uvolňování paměti pro vyrovnávací paměti. S fondy vyrovnávací paměti můžete z fondu vzít vyrovnávací paměť, použít ji a vrátit ji do fondu, až budete hotovi. Tím se vyhnete režijním nákladům při vytváření a ničení vyrovnávacích pamětí.
`maxReceivedMessageSize`	Maximální velikost zprávy v bajtech, včetně hlaviček, kterou může přijímat kanál nakonfigurovaný s touto vazbou. 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ých zpráv. - `Mtom`: Použijte kodér MTOM (Message Transmission Organization Mechanism 1.0). Výchozí formát je `Text`. Tento atribut je typu WSMessageEncoding.
`name`	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í operace otevření. Tato hodnota by měla být větší nebo rovna hodnotě Zero. Výchozí hodnota je 00:01:00.
`proxyAddress`	Identifikátor URI, který určuje adresu proxy serveru HTTP. Pokud `useSystemWebProxy` je `true`, toto nastavení musí být `null`. Výchozí formát je `null`.
`receiveTimeout`	Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení operace příjmu. Tato hodnota by měla být větší nebo rovna hodnotě Zero. Výchozí hodnota je 00:01:00.
`sendTimeout`	Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení operace odeslání. Tato hodnota by měla být větší nebo rovna hodnotě 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 Big Endian. - `Utf16TextEncoding`: 16bitové kódování. - `Utf8TextEncoding`: 8bitové kódování. Výchozí formát je `Utf8TextEncoding`. Tento atribut je typu Encoding.
`transactionFlow`	Hodnota, která určuje, zda vazba podporuje flowing WS-Transactions. Výchozí formát je `false`.
`useDefaultWebProxy`	Hodnota, která určuje, jestli se používá automaticky nakonfigurovaný proxy server HTTP systému. Výchozí formát je `true`.

Podřízené elementy

Element	Popis
<Zabezpečení>	Definuje nastavení zabezpečení pro vazbu. Tento prvek je typu WSHttpSecurityElement.
<readerQuotas>	Definuje omezení složitosti zpráv SOAP, které můžou zpracovat koncové body nakonfigurované pomocí této vazby. Tento prvek je typu XmlDictionaryReaderQuotasElement.
<reliableSession>	Určuje, jestli se mezi koncovými body kanálu navazují spolehlivé relace.

Nadřazené elementy

Element	Popis
<Vazby>	Tento prvek obsahuje kolekci standardních a vlastních vazeb.

Poznámky

Přidá WS2007HttpBinding vazbu poskytovanou systémem, která se WSHttpBinding podobá, ale používá standardní verze protokolů ReliableSession, Security a TransactionFlow (Organization for the Advancement of Structured Information Standards) (OASIS). Při použití této vazby se nevyžadují žádné změny objektového modelu ani výchozího nastavení.

Příklad

<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>

Sdílet prostřednictvím