Delen via

<ws2007HttpBinding>

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

<configuration>
  <system.serviceModel>
    <bindings>
      <ws2007HttpBinding>

Syntaxis

<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.

Attributes

Attribute Description
allowCookies Een waarde die aangeeft of de client cookies accepteert en deze doorgeeft aan toekomstige aanvragen. De standaardwaarde is false.

U kunt deze eigenschap gebruiken wanneer u communiceert met ASP.NET Web Services (ASMX) die cookies gebruiken. 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 een afsluitende bewerking die moet worden voltooid. Deze waarde moet groter dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
hostNameComparisonMode Hiermee geeft u de HTTP-hostnaamvergelijkingsmodus op die wordt gebruikt om Uniform Resource Identifiers (URI's) te parseren. Dit kenmerk is van het type HostNameComparisonMode, wat aangeeft of de hostnaam wordt gebruikt om de service te bereiken wanneer deze overeenkomt met 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 buffergroepen 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 headers, die een kanaal dat is geconfigureerd met deze binding, kan ontvangen. De afzender van een bericht dat deze limiet overschrijdt, ontvangt een SOAP-fout. De ontvanger laat het bericht vallen en maakt een vermelding van de gebeurtenis in het traceerlogboek. De standaardwaarde is 65536.
messageEncoding Hiermee definieert u de encoder die wordt gebruikt om het bericht te coderen. Geldige waarden zijn onder andere:

- Text: Gebruik een tekstberichtcoderingsprogramma.
- Mtom: Gebruik een MTOM-encoder (Message Transmission Organization Mechanism 1.0).

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 hoeven bindingen en gedragingen 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 een geopende bewerking moet worden voltooid. Deze waarde moet groter 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 dat het is true, moet deze instelling zijn null. De standaardwaarde is null.
receiveTimeout Een TimeSpan waarde die het tijdsinterval aangeeft dat een ontvangstbewerking moet worden voltooid. Deze waarde moet groter 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 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 ondersteuning biedt voor stromende WS-Transactions. De standaardwaarde is false.
useDefaultWebProxy Een waarde die aangeeft of de automatisch geconfigureerde HTTP-proxy van het systeem wordt gebruikt. De standaardwaarde is true.

Kind-elementen

Onderdeel Description
<veiligheid> Definieert de beveiligingsinstellingen voor de binding. Dit element is van het type WSHttpSecurityElement.
<readerQuotas> 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 zijn gebracht tussen kanaaleindpunten.

Bovenliggende elementen

Onderdeel Description
<Bindings> Dit element bevat een verzameling standaard- en aangepaste bindingen.

Opmerkingen

Hiermee WS2007HttpBinding wordt een door het systeem geleverde binding toegevoegd die vergelijkbaar is met WSHttpBinding maar die gebruikmaakt van de Organization for the Advancement of Structured Information Standards (OASIS) standaardversies van de ReliableSession-, Security- en TransactionFlow-protocollen. Er zijn geen wijzigingen in het objectmodel of de standaardinstellingen vereist bij het gebruik van deze binding.

Example

<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>

Zie ook

  • Last updated on