<webHttpBinding>

Artikel
04/08/2023

Definierar ett bindningselement som används för att konfigurera slutpunkter för WCF-webbtjänster (Windows Communication Foundation) som svarar på HTTP-begäranden i stället för SOAP-meddelanden.

<Konfiguration>
  <system.serviceModel>
    <Bindningar>
      <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>

Attribut och element

Följande avsnitt beskriver attribut, underordnade element och överordnade element

Attribut

Attribut	Beskrivning
allowCookies	Ett booleskt värde som anger om klienten accepterar cookies och sprider dem på framtida begäranden. Standardvärdet är False. Du kan använda den här egenskapen när du interagerar med ASMX-webbtjänster som använder cookies. På så sätt kan du vara säker på att de cookies som returneras från servern automatiskt kopieras till alla framtida klientbegäranden för tjänsten.
bypassProxyOnLocal	Ett booleskt värde som anger om proxyservern ska kringgås för lokala adresser. Standardvärdet är `false`.
closeTimeout	Ett TimeSpan värde som anger tidsintervallet för en stängningsåtgärd som ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.
hostnameComparisonMode	Anger det HTTP-värdnamnsjämförelseläge som används för att parsa URI:er. Det här attributet är av typen HostNameComparisonMode, vilket anger om värdnamnet används för att nå tjänsten vid matchning på URI:n. Standardvärdet är StrongWildcard, som ignorerar värdnamnet i matchningen.
maxBufferPoolSize	Ett heltal som anger den maximala buffertpoolstorleken för den här bindningen. Standardvärdet är 524 288 byte (512 * 1024). Många delar av Windows Communication Foundation (WCF) använder buffertar. Att skapa och förstöra buffertar varje gång de används är dyrt, och skräpinsamling för buffertar är också dyrt. Med buffertpooler kan du ta en buffert från poolen, använda den och returnera den till poolen när du är klar. Därmed undviks kostnaden för att skapa och förstöra buffertar.
Maxbuffersize	Ett heltal som anger den maximala mängden minne som allokeras för användning av hanteraren för de meddelandebuffertar som tar emot meddelanden från kanalen. Standardvärdet är 524 288 byte (0x80000).
maxReceivedMessageSize	Ett positivt heltal som anger den maximala meddelandestorleken i byte, inklusive rubriker, som kan tas emot på en kanal som konfigurerats med den här bindningen. Avsändaren av ett meddelande som överskrider den här gränsen får ett fel. Mottagaren släpper meddelandet och skapar en post för händelsen i spårningsloggen. Standardvärdet är 65536. Observera: Det räcker inte att bara öka det här värdet i ASP.NET kompatibelt läge. Du bör också öka värdet `httpRuntime` för (se httpRuntime-element (ASP.NET Inställningsschema)).
name	En sträng som innehåller bindningens konfigurationsnamn. Det här värdet bör vara unikt eftersom det används som identifiering för bindningen. Från och med .NET Framework 4 krävs inte bindningar och beteenden för att ha ett namn. Mer information om standardkonfiguration och namnlösa bindningar och beteenden finns i Förenklad konfiguration och förenklad konfiguration för WCF-tjänster.
openTimeout	Ett TimeSpan värde som anger hur länge en öppen åtgärd ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.
proxyAddress	En URI som anger adressen till HTTP-proxyn. Om `useSystemWebProxy` är `true`måste den här inställningen vara `null`. Standardvärdet är `null`.
receiveTimeout	Ett TimeSpan värde som anger hur länge en mottagningsåtgärd ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.
sendTimeout	Ett TimeSpan värde som anger hur länge en sändningsåtgärd ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.
transferMode.	Ett TransferMode värde som anger om tjänsten som konfigurerats med bindningen använder strömmade eller buffrade (eller båda) lägen för meddelandeöverföring. Standardvärdet är `Buffered`.
useDefaultWebProxy	Ett booleskt värde som anger om systemets automatiskt konfigurerade HTTP-proxy används. Standardvärdet är `true`.
writeEncoding	Anger teckenkodningen som används för meddelandetexten. Giltiga värden omfattar följande: UnicodeFffeTextEncoding: Unicode BigEndian-kodning. Utf16TextEncoding: 16-bitars kodning. Utf8TextEncoding: 8-bitars kodning. Standardvärdet är Utf8TextEncoding.

Underordnade element

Element	Beskrivning
<readerQuotas>	Definierar begränsningarna för komplexiteten i POX-meddelanden som kan bearbetas av slutpunkter som konfigurerats med den här bindningen. Det här elementet är av typen XmlDictionaryReaderQuotasElement.
<Säkerhet>	Definierar säkerhetsinställningarna för bindningen. Det här elementet är av typen WebHttpSecurityElement.

Överordnade element

Element	Beskrivning
<Bindningar>	Det här elementet innehåller en samling standard- och anpassade bindningar.

Kommentarer

WCF-webbprogrammeringsmodellen gör det möjligt för utvecklare att exponera WCF-webbtjänster via HTTP-begäranden som använder pox-formatmeddelanden (plain old XML) i stället för SOAP-baserade meddelanden. För att klienter ska kunna kommunicera med en tjänst med HTTP-begäranden måste en slutpunkt för tjänsten konfigureras med den< webHttpBinding> som har <WebHttpBehavior> kopplat till sig.

Stöd i WCF för syndikering och ASP. AJAX-integrering bygger båda på webbprogrammeringsmodellen. Mer information om modellen finns i WCF Web HTTP Programming Model ( WCF Web HTTP Programming Model).

Dela via