Delen via

<basicHttpContextBinding>

Het opgeven van een binding die context biedt voor de BasicHttpBinding uitwisseling door HTTP-cookies in te schakelen als exchange-mechanisme.

<configuration>
  <system.serviceModel>
    <bindings>
      <basicHttpContextBinding>

Syntaxis

<basicHttpContextBinding>
  <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="Aes128/Aes192/Aes256/Rsa15Aes128/ Rsa15Aes256/TripleDes"
               clientCredentialType="UserName/Certificate" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</basicHttpContextBinding>

Kenmerken en elementen

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

Attributes

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

U kunt deze eigenschap gebruiken wanneer u communiceert met ASMX-webservices die cookies gebruiken. Op deze manier kunt u ervoor zorgen 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.

Een internetresource is lokaal als deze een lokaal adres heeft. Een lokaal adres is een adres dat zich op dezelfde computer bevindt, het lokale LAN of intranet en wordt geïdentificeerd, syntactisch, door het ontbreken van een periode (.) zoals in de URI's http://webserver/ en http://localhost/.

Als u dit kenmerk instelt, bepaalt u of eindpunten die zijn geconfigureerd met BasicHttpBinding de proxyserver gebruiken bij toegang tot lokale resources. Als dit kenmerk is true, gebruiken aanvragen voor lokale internetbronnen de proxyserver niet. Gebruik de hostnaam (in plaats van localhost) als u wilt dat clients een proxy doorlopen wanneer ze met services op dezelfde computer praten wanneer dit kenmerk is ingesteld op true.

Wanneer dit kenmerk is false, worden alle internetaanvragen gedaan via de proxyserver.
closeTimeout Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor een sluitingsbewerking 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 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 Een geheel getal dat de maximale hoeveelheid geheugen aangeeft die wordt toegewezen voor gebruik door de manager van de berichtbuffers die berichten ontvangen van het kanaal. De standaardwaarde is 524288 (0x80000) bytes.

Bufferbeheer minimaliseert de kosten van het gebruik van buffers met behulp van een buffergroep. Buffers zijn vereist voor het verwerken van berichten door de service wanneer ze uit het kanaal komen. Als er onvoldoende geheugen in de buffergroep is om de berichtbelasting te verwerken, moet bufferbeheer extra geheugen toewijzen vanuit de CLR-heap, waardoor de overhead van de garbagecollection toeneemt. Uitgebreide toewijzing van de CLR-garbage-heap is een indicatie dat de grootte van de buffergroep te klein is en dat de prestaties kunnen worden verbeterd met een grotere toewijzing door de limiet te verhogen die door dit kenmerk is opgegeven.
maxBufferSize Een geheel getal dat de maximale grootte, in bytes, aangeeft van een buffer waarin berichten worden opgeslagen terwijl ze worden verwerkt voor een eindpunt dat is geconfigureerd met deze binding. De standaardwaarde is 65.536 bytes.
maxReceivedMessageSize Een positief geheel getal dat de maximale berichtgrootte definieert, in bytes, inclusief kopteksten, voor een bericht dat kan worden ontvangen op een kanaal dat is geconfigureerd met deze binding. De afzender ontvangt een SOAP-fout als het bericht te groot is voor de ontvanger. De ontvanger laat het bericht vallen en maakt een vermelding van de gebeurtenis in het traceerlogboek. De standaardwaarde is 65.536 bytes.
messageEncoding Hiermee definieert u de encoder die wordt gebruikt om het SOAP-bericht te coderen. Geldige waarden zijn onder andere:

- Tekst: Gebruik een coderingsprogramma voor tekstberichten.
- Mtom: Een Message Transmission Organization Mechanism 1.0 -encoder (MTOM) gebruiken.

De standaardwaarde is de tekst. Dit kenmerk is van het type WSMessageEncoding.
messageVersion Hiermee geeft u de berichtversie op die wordt gebruikt door clients en services die zijn geconfigureerd met de binding. Dit kenmerk is van het type MessageVersion.
name 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 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 bevat. Als useSystemWebProxy deze instelling is ingesteld op 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:10: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 stelt u de tekensetcodering in die moet worden gebruikt voor het verzenden van berichten op de binding. Geldige waarden zijn onder andere:

- BigEndianUnicode: Unicode BigEndian-codering.
- Unicode: 16-bits codering.
- UTF8: 8-bits codering

De standaardwaarde is UTF8. Dit kenmerk is van het type Encoding.
transferMode Een geldige TransferMode waarde die aangeeft of berichten worden gebufferd of gestreamd op een aanvraag of antwoord.
useDefaultWebProxy Een Booleaanse waarde die aangeeft of de automatisch geconfigureerde HTTP-proxy van het systeem moet worden gebruikt, indien beschikbaar. De standaardwaarde is true.

Kind-elementen

Onderdeel Description
<veiligheid> Definieert de beveiligingsinstellingen voor de binding. Dit element is van het type BasicHttpSecurityElement.
<readerQuotas> Definieert de beperkingen voor de complexiteit van SOAP-berichten die kunnen worden verwerkt door eindpunten die met deze binding zijn geconfigureerd. Dit element is van het type XmlDictionaryReaderQuotasElement.

Bovenliggende elementen

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

Opmerkingen

Dit bindingselement biedt een beveiligingsniveau en een uitwisselingsmechanisme als onderdeel van de context voor een BasicHttpBinding.

Zie ook

  • Last updated on