<webHttpBinding>

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

<configuration>
  <system.serviceModel>
    <bindings>
      <webHttpBinding>

Syntaxe

<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 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í.
maxBufferSize Celé číslo, které určuje maximální množství paměti, které je přiděleno 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é pomocí této vazby. 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í této hodnoty nestačí v ASP.NET kompatibilním režimu. Měli byste také zvýšit hodnotu httpRuntime (viz httpRuntime – element (ASP.NET Settings Schema)).
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.
Transfermode. Hodnota TransferMode , která označuje, zda služba nakonfigurovaná pomocí vazby používá streamované nebo vyrovnávací paměti (nebo oba) režimy přenosu zpráv. Výchozí hodnota je Buffered.
useDefaultWebProxy Logická hodnota, která určuje, jestli se používá automaticky nakonfigurovaný proxy server HTTP systému. Výchozí hodnota 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é prvky

prvek Description
<readerQuotas> Definuje omezení složitosti zpráv POX, které lze zpracovat koncovými body nakonfigurovanými s touto vazbou. Tento prvek je typu XmlDictionaryReaderQuotasElement.
<bezpečnost> Definuje nastavení zabezpečení pro vazbu. Tento prvek je typu WebHttpSecurityElement.

Nadřazené prvky

prvek Description
<na něčí žádosti> Tento element 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í "prosté staré XML" (POX) zasílání zpráv. Aby klienti mohli komunikovat se službou pomocí požadavků HTTP, musí být koncový bod služby nakonfigurovaný s <webHttpBindingem> , který má <k ní připojený WebHttpBehavior> .

Podpora wcf pro syndikaci a ASP Integrace AJAX je založená na webovém programovacím modelu. Další informace o modelu naleznete v tématu WCF Web HTTP Programming Model.

Viz také

  • Last updated on