<ws2007HttpBinding>

Artikel
04/08/2023

Definieert een interoperabele binding die ondersteuning biedt voor de juiste versies van de Securitybindingselementen , ReliableSessionen TransactionFlow .

<Configuratie>
  <system.serviceModel>
    <Bindings>
      <ws2007HttpBinding>

Syntax

<ws2007HttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxReceivedMessageSize="Integer"
           messageEncoding="Text/Mtom"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
           transactionFlow="Boolean"
           useDefaultWebProxy="Boolean">
    <reliableSession ordered="Boolean"
                     inactivityTimeout="TimeSpan"
                     enabled="Boolean" />
    <security mode="Message/None/Transport/TransportWithCredential">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
        <message clientCredentialType ="Certificate/IssuedToken/None/UserName/Windows"
                 negotiateServiceCredential="Boolean"
                 algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
                 establishSecurityContext="Boolean" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</ws2007HttpBinding>

Kenmerken en elementen

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

Kenmerken

Kenmerk	Beschrijving
`allowCookies`	Een waarde die aangeeft of de client cookies accepteert en doorgeeft op toekomstige aanvragen. De standaardwaarde is `false`. U kunt deze eigenschap gebruiken wanneer u communiceert met ASP.NET Web Services (ASMX) die gebruikmaken van cookies. Dit zorgt ervoor dat cookies die de server retourneert, automatisch worden gekopieerd naar alle toekomstige clientaanvragen voor die service.
`bypassProxyOnLocal`	Een waarde die aangeeft of de proxyserver voor lokale adressen moet worden overgeslagen. De standaardwaarde is `false`.
`closeTimeout`	Een TimeSpan waarde die het tijdsinterval aangeeft voor het voltooien van een close-bewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
`hostNameComparisonMode`	Hiermee geeft u de HTTP-hostnaamvergelijkingsmodus op die wordt gebruikt om URI's (Uniform Resource Identifiers) te parseren. Dit kenmerk is van het type HostNameComparisonMode, dat aangeeft of de hostnaam wordt gebruikt om de service te bereiken bij het vergelijken op de URI. De standaardwaarde is StrongWildcard, waarmee de hostnaam in de overeenkomst wordt genegeerd.
`maxBufferPoolSize`	De maximale buffergroepgrootte voor deze binding. 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 telkens wanneer ze worden gebruikt, is duur, net als garbagecollection voor buffers. Met bufferpools kunt u een buffer uit de pool nemen, deze gebruiken en teruggaan naar de pool wanneer u klaar bent. Dit voorkomt de overhead bij het maken en vernietigen van buffers.
`maxReceivedMessageSize`	De maximale berichtgrootte, in bytes, inclusief kopteksten, die een kanaal dat met deze binding is geconfigureerd, kan ontvangen. De afzender van een bericht dat deze limiet overschrijdt, ontvangt een SOAP-fout. De ontvanger verwijdert het bericht en maakt een vermelding van de gebeurtenis in het traceringslogboek. De standaardwaarde is 65536.
`messageEncoding`	Definieert de encoder die wordt gebruikt om het bericht te coderen. Geldige waarden zijn onder andere: - `Text`: gebruik een tekstberichtcoderingsprogramma. - `Mtom`: Gebruik een Message Transmission Organization Mechanism 1.0-encoder (MTOM). De standaardwaarde is `Text`. Dit kenmerk is van het type WSMessageEncoding.
`name`	De configuratienaam van de binding. Deze waarde moet uniek zijn omdat deze wordt gebruikt als identificatie voor de binding. Vanaf .NET Framework 4 zijn bindingen en gedrag niet vereist om een 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 een open bewerking moet worden voltooid. 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 opgegeven tijdsinterval aangeeft 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 een verzendbewerking moet worden voltooid. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
`textEncoding`	Hiermee geeft u de tekensetcodering die moet worden gebruikt voor het verzenden van berichten op de binding. Geldige waarden zijn onder andere: - `UnicodeFffeTextEncoding`: Unicode Big Endian-codering. - `Utf16TextEncoding`: 16-bits codering. - `Utf8TextEncoding`: 8-bits codering. De standaardwaarde is `Utf8TextEncoding`. Dit kenmerk is van het type Encoding.
`transactionFlow`	Een waarde die aangeeft of de binding stromende WS-transactions ondersteunt. De standaardwaarde is `false`.
`useDefaultWebProxy`	Een waarde die aangeeft of de automatisch geconfigureerde HTTP-proxy van het systeem wordt gebruikt. De standaardwaarde is `true`.

Onderliggende elementen

Element	Beschrijving
<Veiligheid>	Definieert de beveiligingsinstellingen voor de binding. Dit element is van het type WSHttpSecurityElement.
<lezerQuota's>	Definieert de beperkingen voor de complexiteit van SOAP-berichten die eindpunten die met deze binding zijn geconfigureerd, kunnen verwerken. Dit element is van het type XmlDictionaryReaderQuotasElement.
<reliableSession>	Hiermee geeft u op of er betrouwbare sessies tot stand worden gebracht tussen kanaaleindpunten.

Bovenliggende elementen

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

Opmerkingen

De WS2007HttpBinding voegt een door het systeem geleverde binding toe die WSHttpBinding vergelijkbaar is met, maar maakt gebruik van de standaardversies van de OASIS-standaardversies (Organization for the Advancement of Structured Information Standards) van de protocollen ReliableSession, Security en TransactionFlow. Er zijn geen wijzigingen in het objectmodel of de standaardinstellingen vereist wanneer u deze binding gebruikt.

Voorbeeld

<configuration>
  <system.ServiceModel>
    <bindings>
      <ws2007HttpBinding>
        <binding closeTimeout="00:00:10"
                 openTimeout="00:00:20"
                 receiveTimeout="00:00:30"
                 sendTimeout="00:00:40"
                 bypassProxyOnLocal="false"
                 transactionFlow="false"
                 hostNameComparisonMode="WeakWildcard"
                 maxReceivedMessageSize="1000"
                 messageEncoding="Mtom"
                 proxyAddress="http://www.contoso.com"
                 textEncoding="utf-16"
                 useDefaultWebProxy="false">
          <reliableSession ordered="false"
                           inactivityTimeout="00:02:00"
                           enabled="true" />
          <security mode="Transport">
            <transport clientCredentialType="Digest"
                       proxyCredentialType="None"
                       realm="someRealm" />
            <message clientCredentialType="Windows"
                     negotiateServiceCredential="false"
                     algorithmSuite="Aes128"
                     defaultProtectionLevel="None" />
          </security>
        </binding>
      </ws2007HttpBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

Delen via