<basicHttpBinding>

Představuje vazbu, kterou může služba WCF (Windows Communication Foundation) použít ke konfiguraci a zveřejnění koncových bodů, které jsou schopné komunikovat s webovými službami a klienty založenými na ASMX a dalšími službami, které odpovídají WS-I základní profil 1.1.

<configuration>
  <system.serviceModel>
    <bindings>
      <basicHttpBinding>

Syntaxe

<basicHttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="Integer"
           maxBufferSize="Integer"
           maxReceivedMessageSize="Integer"
           messageEncoding="Text/Mtom"
           name="String"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
           useDefaultWebProxy="Boolean">
    <security mode="None/Transport/Message/TransportWithMessageCredential/TransportCredentialOnly">
      <transport clientCredentialType="None/Basic/Digest/Ntlm/Windows/Certificate"
                 proxyCredentialType="None/Basic/Digest/Ntlm/Windows"
                 realm="String" />
      <message algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
               clientCredentialType="UserName/Certificate" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</basicHttpBinding>

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. Internetový prostředek je místní, pokud má místní adresu. Místní adresa je adresa, která je na stejném počítači, místní síť LAN nebo intranet a je identifikována syntakticky nedostatkem tečky (.) jako v identifikátorech http://webserver/ URI a http://localhost/. Nastavení tohoto atributu určuje, zda koncové body nakonfigurované pomocí BasicHttpBinding používají proxy server při přístupu k místním prostředkům. Pokud je truetento atribut , požadavky na místní internetové prostředky nepoužívají proxy server. Pokud chcete, aby klienti procházeli proxy serverem při komunikaci se službami na stejném počítači, pokud je tento atribut nastavený na true, použijte název hostitele (nikoli localhost). Pokud je falsetento atribut , všechny internetové požadavky jsou provedeny prostřednictvím proxy serveru.
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	Celočíselná hodnota, která určuje maximální množství 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 524288 (0x80000) bajtů. Správce vyrovnávací paměti minimalizuje náklady na používání vyrovnávacích pamětí pomocí fondu vyrovnávacích pamětí. Vyrovnávací paměti jsou vyžadovány ke zpracování zpráv službou, když přicházejí z kanálu. Pokud ve fondu vyrovnávací paměti není dostatek paměti ke zpracování zatížení zprávy, správce vyrovnávací paměti musí přidělit další paměť z haldy CLR, což zvyšuje režii uvolňování paměti. Rozsáhlé přidělení z haldy uvolňování paměti CLR značí, že velikost fondu vyrovnávací paměti je příliš malá a že výkon lze zlepšit větším přidělením zvýšením limitu určeného tímto atributem.
maxBufferSize	Celočíselná hodnota, která určuje maximální velikost vyrovnávací paměti, která ukládá zprávy během jejich zpracování pro koncový bod nakonfigurovaný touto vazbou. Výchozí hodnota je 65 536 bajtů.
maxReceivedMessageSize	Kladné celé číslo, které definuje maximální velikost zprávy v bajtech, včetně hlaviček, pro zprávu, kterou lze přijímat v kanálu nakonfigurovaného s touto vazbou. Odesílatel obdrží chybu SOAP, pokud je zpráva pro příjemce příliš velká. Příjemce zprávu zahodí a vytvoří záznam události v protokolu trasování. Výchozí hodnota je 65 536 bajtů.
messageEncoding	Definuje kodér použitý ke kódování zprávy SOAP. 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.
name	Řetězec, který obsahuje název konfigurace vazby. Tato hodnota by měla být jedinečná mezi vazbami stejného typu. 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ý obsahuje adresu proxy serveru HTTP. Je-li useSystemWebProxy nastavena na truehodnotu , musí být nulltoto nastavení . 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:10: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.
transferMode	Platná TransferMode hodnota, která určuje, jestli se zprávy ukládají do vyrovnávací paměti nebo streamují v požadavku nebo odpovědi.
useDefaultWebProxy	Logická hodnota, která určuje, jestli se má použít automaticky nakonfigurovaný proxy server HTTP systému, pokud je k dispozici. Výchozí hodnota je true.

Podřízené prvky

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

Nadřazené prvky

prvek	Description
<na něčí žádosti>	Tento element obsahuje kolekci standardních a vlastních vazeb.

Poznámky

BasicHttpBinding používá protokol HTTP jako přenos pro odesílání zpráv SOAP 1.1. Služba může tuto vazbu použít ke zveřejnění koncových bodů, které odpovídají WS-I BP 1.1, například těch, které klienti ASMX spotřebovávají. Podobně může klient použít BasicHttpBinding ke komunikaci se službami, které zveřejňují koncové body odpovídající WS-I BP 1.1, jako jsou webové služby ASMX nebo služby nakonfigurované pomocí BasicHttpBinding.

Zabezpečení je ve výchozím nastavení vypnuté, ale lze přidat nastavení atributu režimu podřízeného <prvku zabezpečení> na jinou hodnotu než None. Ve výchozím nastavení používá kódování zpráv "Text" a kódování textu UTF-8.

Příklad 1

Následující příklad ukazuje použití BasicHttpBinding , které poskytuje komunikaci HTTP a maximální interoperabilitu s webovými službami první a druhé generace. Vazba je určena v konfiguračních souborech klienta a služby. Typ vazby je určen pomocí binding atributu elementu <endpoint> . Pokud chcete nakonfigurovat základní vazbu a změnit některá její nastavení, je nutné definovat konfiguraci vazby. Koncový bod musí odkazovat na konfiguraci vazby podle názvu pomocí bindingConfiguration atributu <endpoint> elementu, jak je znázorněno v následujícím konfiguračním kódu pro službu.

<system.serviceModel>
  <services>
    <service type="Microsoft.ServiceModel.Samples.CalculatorService"
             behaviorConfiguration="CalculatorServiceBehavior">
      <endpoint address=""
                binding="basicHttpBinding"
                bindingConfiguration="Binding1"
                contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </service>
  </services>
  <bindings>
    <basicHttpBinding>
      <binding name="Binding1"
               hostNameComparisonMode="StrongWildcard"
               receiveTimeout="00:10:00"
               sendTimeout="00:10:00"
               openTimeout="00:10:00"
               closeTimeout="00:10:00"
               maxReceivedMessageSize="65536"
               maxBufferSize="65536"
               maxBufferPoolSize="524288"
               transferMode="Buffered"
               messageEncoding="Text"
               textEncoding="utf-8"
               bypassProxyOnLocal="false"
               useDefaultWebProxy="true">
        <security mode="None" />
      </binding>
    </basicHttpBinding>
  </bindings>
</system.serviceModel>

Příklad 2

Počínaje rozhraním .NET Framework 4 není nutné, aby vazby a chování měly název. Funkce z předchozího příkladu lze provést odebráním bindingConfiguration z adresy koncového bodu a názvem z vazby.

<system.serviceModel>
  <services>
    <service type="Microsoft.ServiceModel.Samples.CalculatorService"
             behaviorConfiguration="CalculatorServiceBehavior">
      <endpoint address=""
                binding="basicHttpBinding"
                contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </service>
  </services>
  <bindings>
    <basicHttpBinding>
      <binding hostNameComparisonMode="StrongWildcard"
               receiveTimeout="00:10:00"
               sendTimeout="00:10:00"
               openTimeout="00:10:00"
               closeTimeout="00:10:00"
               maxReceivedMessageSize="65536"
               maxBufferSize="65536"
               maxBufferPoolSize="524288"
               transferMode="Buffered"
               messageEncoding="Text"
               textEncoding="utf-8"
               bypassProxyOnLocal="false"
               useDefaultWebProxy="true">
        <security mode="None" />
      </binding>
    </basicHttpBinding>
  </bindings>
</system.serviceModel>

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.

Viz také

• Binding
• BindingElement
• BasicHttpBinding
• BasicHttpBindingElement
• Spojení
• Konfigurace vazeb System-Provided
• Použití vazeb ke konfiguraci služeb a klientů
• <závazný>