<webHttpBinding>

Artikel
06/21/2023

Definieert een bindingselement dat wordt gebruikt voor het configureren van eindpunten voor WCF-webservices (Windows Communication Foundation) die reageren op HTTP-aanvragen in plaats van SOAP-berichten.

<Configuratie>
  <system.serviceModel>
    <Bindings>
      <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>

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven

Kenmerken

Kenmerk	Beschrijving
allowCookies	Een Booleaanse waarde die aangeeft of de client cookies accepteert en doorgeeft bij toekomstige aanvragen. De standaardwaarde is false. U kunt deze eigenschap gebruiken wanneer u communiceert met ASMX-webservices die gebruikmaken van cookies. Op deze manier kunt u er zeker van zijn dat de cookies die van de server worden geretourneerd, automatisch worden gekopieerd naar alle toekomstige clientaanvragen voor die service.
bypassProxyOnLocal	Een Booleaanse waarde die aangeeft of de proxyserver voor lokale adressen moet worden overgeslagen. De standaardwaarde is `false`.
closeTimeout	Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor het voltooien van een bijna-bewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
hostnaamComparisonMode	Hiermee geeft u de http-hostnaamvergelijkingsmodus op die wordt gebruikt voor het parseren van URI's. Dit kenmerk is van het type HostNameComparisonMode, waarmee wordt aangegeven of de hostnaam wordt gebruikt om de service te bereiken bij het vergelijken op de URI. De standaardwaarde is StrongWildcard, waarbij de hostnaam in de overeenkomst wordt genegeerd.
maxBufferPoolSize	Een geheel getal dat de maximale grootte van de buffergroep voor deze binding aangeeft. De standaardwaarde is 524.288 bytes (512 * 1024). Veel onderdelen van Windows Communication Foundation (WCF) maken gebruik van buffers. Het maken en vernietigen van buffers elke keer dat ze worden gebruikt, is duur en garbagecollection voor buffers is ook duur. Met bufferpools kunt u een buffer uit de pool nemen, deze gebruiken en teruggaan naar de pool zodra u klaar bent. Zo wordt de overhead bij het maken en vernietigen van buffers vermeden.
Maxbuffersize	Een geheel getal dat de maximale hoeveelheid geheugen aangeeft die is toegewezen voor gebruik door de manager van de berichtbuffers die berichten van het kanaal ontvangen. De standaardwaarde is 524.288 (0x80000) bytes.
maxReceivedMessageSize	Een positief geheel getal dat de maximale berichtgrootte aangeeft, in bytes, inclusief headers, die kunnen worden ontvangen op een kanaal dat is geconfigureerd met deze binding. De afzender van een bericht dat deze limiet overschrijdt, ontvangt een fout. De ontvanger verwijdert het bericht en maakt een vermelding van de gebeurtenis in het traceringslogboek. De standaardwaarde is 65536. Opmerking: Het verhogen van deze waarde alleen is niet voldoende in ASP.NET compatibele modus. U moet ook de waarde van `httpRuntime` verhogen (zie httpRuntime-element (ASP.NET Instellingenschema)).
naam	Een tekenreeks die de configuratienaam van de binding bevat. Deze waarde moet uniek zijn omdat deze wordt gebruikt als identificatie voor de binding. Vanaf .NET Framework 4 hoeven bindingen en gedrag geen naam te hebben. Zie Vereenvoudigde configuratie en vereenvoudigde configuratie voor WCF-services voor meer informatie over standaardconfiguratie en naamloze bindingen en gedrag.
openTimeout	Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor het voltooien van een open bewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
proxyAddress	Een URI die het adres van de HTTP-proxy aangeeft. Als `useSystemWebProxy` is `true`, moet deze instelling zijn `null`. De standaardwaarde is `null`.
receiveTimeout	Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor het voltooien van een ontvangstbewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
sendTimeout	Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor het voltooien van een verzendbewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
transferMode.	Een TransferMode waarde die aangeeft of de service die is geconfigureerd met de binding gebruikmaakt van gestreamde of gebufferde (of beide) modi voor berichtoverdracht. De standaardwaarde is `Buffered`.
useDefaultWebProxy	Een Booleaanse waarde die aangeeft of de automatisch geconfigureerde HTTP-proxy van het systeem wordt gebruikt. De standaardwaarde is `true`.
writeEncoding	Hiermee geeft u de tekencodering die wordt gebruikt voor de berichttekst. Geldige waarden zijn onder andere: UnicodeFffeTextEncoding: Unicode BigEndian-codering. Utf16TextEncoding: 16-bits codering. Utf8TextEncoding: 8-bits codering. De standaardwaarde is Utf8TextEncoding.

Onderliggende elementen

Element	Beschrijving
<readerQuotas>	Definieert de beperkingen voor de complexiteit van POX-berichten die kunnen worden verwerkt door eindpunten die met deze binding zijn geconfigureerd. Dit element is van het type XmlDictionaryReaderQuotasElement.
<Veiligheid>	Definieert de beveiligingsinstellingen voor de binding. Dit element is van het type WebHttpSecurityElement.

Bovenliggende elementen

Element	Beschrijving
<Bindings>	Dit element bevat een verzameling standaard- en aangepaste bindingen.

Opmerkingen

Met het WCF-webprogrammeringsmodel kunnen ontwikkelaars WCF-webservices beschikbaar maken via HTTP-aanvragen die gebruikmaken van berichten in pox-stijl (plain old XML) in plaats van op SOAP gebaseerde berichten. Clients kunnen alleen communiceren met een service met behulp van HTTP-aanvragen als een eindpunt van de service wordt geconfigureerd met de <webHttpBinding> waaraan de <WebHttpBehavior> is gekoppeld.

Ondersteuning in WCF voor syndicatie en ASP. AJAX-integratie is beide gebaseerd op het Web Programming Model. Zie WCF Web HTTP Programming Model voor meer informatie over het model.

Delen via