Dela via

<basicHttpContextBinding>

  • Artikel

Ange en bindning som ger kontext för den BasicHttpBinding som ska bytas ut genom att aktivera HTTP-cookies som exchange-mekanism.

<Konfiguration>
  <system.serviceModel>
    <Bindningar>
      <basicHttpContextBinding>

Syntax

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

Attribut och element

I följande avsnitt beskrivs 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.

En Internetresurs är lokal om den har en lokal adress. En lokal adress är en som finns på samma dator, det lokala LAN eller intranätet och identifieras syntaktiskt av bristen på en punkt (.) som i URI:erna http://webserver/ och http://localhost/.

Om du anger det här attributet avgör du om slutpunkter som konfigurerats med BasicHttpBinding använder proxyservern vid åtkomst till lokala resurser. Om det här attributet är trueanvänder begäranden till lokala Internetresurser inte proxyservern. Använd värdnamnet (i stället för localhost) om du vill att klienter ska gå igenom en proxy när de pratar med tjänster på samma dator när det här attributet är inställt på true.

När det här attributet är falsegörs alla Internetbegäranden via proxyservern.
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 heltalsvärde som anger den maximala mängden minne som allokeras för användning av chefen för de meddelandebuffertar som tar emot meddelanden från kanalen. Standardvärdet är 524288 (0x80000) byte.

Buffer Manager minimerar kostnaden för att använda buffertar med hjälp av en buffertpool. Buffertar krävs för att bearbeta meddelanden från tjänsten när de kommer ut ur kanalen. Om det inte finns tillräckligt med minne i buffertpoolen för att bearbeta meddelandebelastningen måste Buffer Manager allokera ytterligare minne från CLR-heapen, vilket ökar mängden skräpinsamling. Omfattande allokering från CLR-skräphögen är en indikation på att buffertpoolens storlek är för liten och att prestanda kan förbättras med en större allokering genom att öka den gräns som anges av det här attributet.
maxBufferSize Ett heltalsvärde som anger den maximala storleken i byte för en buffert som lagrar meddelanden medan de bearbetas för en slutpunkt som konfigurerats med den här bindningen. Standardvärdet är 65 536 byte.
maxReceivedMessageSize Ett positivt heltal som definierar den maximala meddelandestorleken, i byte, inklusive rubriker, för ett meddelande som kan tas emot på en kanal som konfigurerats med den här bindningen. Avsändaren får ett SOAP-fel om meddelandet är för stort för mottagaren. Mottagaren släpper meddelandet och skapar en post för händelsen i spårningsloggen. Standardvärdet är 65 536 byte.
messageEncoding Definierar kodaren som används för att koda SOAP-meddelandet. Giltiga värden omfattar följande:

- Text: Använd en textmeddelandekodare.
– Mtom: Använd en MTOM-kodare (Message Transmission Organization Mechanism 1.0).

Standardvärdet är Text. Det här attributet är av typen WSMessageEncoding.
messageVersion Anger den meddelandeversion som används av klienter och tjänster som konfigurerats med bindningen. Det här attributet är av typen MessageVersion.
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 innehåller adressen till HTTP-proxyn. Om useSystemWebProxy är inställt på truemå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:10: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.
textEncoding Anger teckenuppsättningskodningen som ska användas för att generera meddelanden på bindningen. Giltiga värden omfattar följande:

- BigEndianUnicode: Unicode BigEndian-kodning.
- Unicode: 16-bitars kodning.
- UTF8: 8-bitars kodning

Standardvärdet är UTF8. Det här attributet är av typen Encoding.
transferMode Ett giltigt TransferMode värde som anger om meddelanden buffrats eller strömmats på en begäran eller ett svar.
useDefaultWebProxy Ett booleskt värde som anger om den automatiskt konfigurerade HTTP-proxyn för systemet ska användas, om det är tillgängligt. Standardvärdet är true.

Underordnade element

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

Överordnade element

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

Kommentarer

Det här bindningselementet tillhandahåller en skyddsnivå och en utbytesmekanism som en del av kontexten för en BasicHttpBinding.

Se även