<webHttpBinding>

Článek
05/10/2023

Definuje element vazby, který se používá ke konfiguraci koncových bodů pro webové služby Windows Communication Foundation (WCF), které reagují na požadavky HTTP místo zpráv SOAP.

<Konfigurace>
  <System.servicemodel>
    <Vazby>
      <webHttpBinding>

Syntax

<webHttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxBufferSize="integer"
           maxReceivedMessageSize="Integer"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
           useDefaultWebProxy="Boolean"
           writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding">
    <security mode="None/Transport/TransportCredentialOnly">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</webHttpBinding>

Atributy a elementy

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

Atributy

Atribut	Popis
allowCookies	Logická hodnota, která označuje, jestli klient přijímá soubory cookie a šíří je v budoucích požadavcích. Výchozí hodnotou je hodnota 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 se soubory cookie vrácené ze serveru automaticky zkopírují do všech budoucích požadavků klientů pro tuto službu.
Bypassproxyonlocal	Logická hodnota označující, 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 zadaný pro 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. 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	Celé číslo, které určuje maximální velikost fondu vyrovnávacích pamětí 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 nič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é. S fondy vyrovnávacích pamětí můžete z fondu vzít vyrovnávací paměť, použít ji a po dokončení ji vrátit do fondu. Tím se vyhnete režijnímu zatížení při vytváření a ničení vyrovnávacích pamětí.
Maxbuffersize	Celé číslo, které určuje maximální velikost paměti přidělené pro použití správcem vyrovnávacích pamětí zpráv, které přijímají zprávy z kanálu. Výchozí hodnota je 524 288 bajtů (0x80000).
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ého s touto vazbou. Odesílatel zprávy překračující tento limit obdrží chybu. Příjemce zprávu zahodí a vytvoří záznam události v protokolu trasování. Výchozí hodnota je 65536. Poznámka: Zvýšení samotné hodnoty není v ASP.NET kompatibilním režimu dostatečné. Měli byste také zvýšit hodnotu `httpRuntime` (viz element httpRuntime (ASP.NET Schéma nastavení)).
name	Řetězec, který obsahuje konfigurační název 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.
Transfermode.	Hodnota TransferMode , která označuje, jestli služba nakonfigurovaná s vazbou používá streamovaný režim přenosu zpráv nebo režim přenosu zpráv ve vyrovnávací paměti (nebo oba režimy). Výchozí formát je `Buffered`.
useDefaultWebProxy	Logická hodnota, která určuje, jestli se používá automaticky nakonfigurovaný proxy server HTTP systému. Výchozí formát je `true`.
writeEncoding	Určuje kódování znaků, které se používá pro text zprávy. 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.

Podřízené elementy

Element	Popis
<readerQuotas>	Definuje omezení složitosti zpráv POX, které mohou být zpracovány koncovými body nakonfigurovanými pomocí této vazby. Tento prvek je typu XmlDictionaryReaderQuotasElement.
<Zabezpečení>	Definuje nastavení zabezpečení pro vazbu. Tento prvek je typu WebHttpSecurityElement.

Nadřazené elementy

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

Poznámky

Webový programovací model WCF umožňuje vývojářům zpřístupnit webové služby WCF prostřednictvím požadavků HTTP, které místo zasílání zpráv založených na protokolu SOAP používají zasílání zpráv ve stylu prostého starého XML (POX). Aby klienti komunikovali se službou pomocí požadavků HTTP, musí být koncový bod služby nakonfigurovaný s <webHttpBinding> , ke kterému je <připojený webHttpBehavior> .

Podpora ve WCF pro syndikaci a ASP. Integrace AJAX je postavena na modelu webového programování. Další informace o modelu najdete v tématu Webový programovací model HTTP WCF.

Sdílet prostřednictvím