<basicHttpContextBinding>

Olyan kötés megadása, amely a HTTP-cookie-k cseremechanizmusként való engedélyezésével kontextust BasicHttpBinding biztosít a kicseréléshez.

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

Szemantika

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

Attribútumok és elemek

A következő szakaszok az attribútumokat, a gyermekelemeket és a szülőelemeket ismertetik.

Attributes

Attribute Description
allowCookies Logikai érték, amely jelzi, hogy az ügyfél elfogadja-e a cookie-kat, és propagálja-e őket a jövőbeli kérések során. Az alapértelmezett érték a false.

Ezt a tulajdonságot akkor használhatja, ha cookie-kat használó ASMX webszolgáltatásokkal kommunikál. Ily módon biztos lehet abban, hogy a kiszolgálóról visszaadott cookie-k automatikusan át lesznek másolva az adott szolgáltatásra vonatkozó összes jövőbeli ügyfélkérésre.
bypassProxyOnLocal Logikai érték, amely azt jelzi, hogy a helyi címek proxykiszolgálójának megkerülése szükséges-e. Az alapértelmezett érték a false.

Az internetes erőforrások helyiek, ha helyi címmel rendelkezik. A helyi cím olyan, amely ugyanazon a számítógépen, a helyi LAN-on vagy intraneten található, és szintaktikailag egy pont (.) hiánya azonosítja, mint az URI-kban http://webserver/ és http://localhost/a .

Az attribútum beállítása határozza meg, hogy az AlapszintűHttpBinding szolgáltatással konfigurált végpontok a proxykiszolgálót használják-e a helyi erőforrások elérésekor. Ha ez az attribútum, truea helyi internetes erőforrásokra irányuló kérések nem használják a proxykiszolgálót. Használja a gazdagép nevét (a localhost helyett), ha azt szeretné, hogy az ügyfelek proxyn keresztül menjenek keresztül, amikor ugyanazon a gépen lévő szolgáltatásokhoz beszélnek, amikor ez az attribútum be van állítva true.

Ha ez az attribútum, falseaz összes internetes kérés a proxykiszolgálón keresztül történik.
closeTimeout Egy TimeSpan olyan érték, amely megadja a záró művelet végrehajtásához megadott időintervallumot. Ennek az értéknek nagyobbnak vagy egyenlőnek Zerokell lennie. Az alapértelmezett érték 00:01:00.
hostNameComparisonMode Megadja az URI-k elemzéséhez használt HTTP-állomásnév-összehasonlító módot. Ez az attribútum típus HostNameComparisonMode, amely azt jelzi, hogy a gazdagépnév a szolgáltatás elérésére szolgál-e az URI-n való egyeztetéskor. Az alapértelmezett érték az StrongWildcard, amely figyelmen kívül hagyja a gazdanevet az egyezésben.
maxBufferPoolSize Egész számérték, amely meghatározza, hogy a csatorna üzeneteit fogadó üzenetpufferek kezelője mekkora mennyiségű memóriát foglal le. Az alapértelmezett érték 524288 (0x80000) bájt.

A Pufferkezelő minimálisra csökkenti a pufferek pufferkészlet használatával történő használatának költségeit. A pufferek szükségesek ahhoz, hogy a szolgáltatás feldolgozhassa az üzeneteket, amikor kijönnek a csatornából. Ha nincs elegendő memória a pufferkészletben az üzenetbetöltés feldolgozásához, a Pufferkezelőnek további memóriát kell lefoglalnia a CLR-halomból, ami növeli a szemétgyűjtés többletterhelését. A CLR-szemét halomból való kiterjedt kiosztás azt jelzi, hogy a pufferkészlet mérete túl kicsi, és hogy a teljesítmény nagyobb lefoglalással növelhető az attribútum által megadott korlát növelésével.
maxBufferSize Egy egész számérték, amely bájtban határozza meg az üzeneteket tároló puffer maximális méretét, miközben a kötéssel konfigurált végponton dolgozzák fel őket. Az alapértelmezett érték 65 536 bájt.
maxReceivedMessageSize Pozitív egész szám, amely bájtban határozza meg az üzenet maximális méretét, beleértve a fejléceket is, egy üzenethez, amely az ezzel a kötéssel konfigurált csatornán fogadható. A feladó SOAP-hibát kap, ha az üzenet túl nagy a fogadó számára. A fogadó eldobja az üzenetet, és létrehozza az esemény bejegyzését a nyomkövetési naplóban. Az alapértelmezett érték 65 536 bájt.
messageEncoding Meghatározza a SOAP-üzenet kódolásához használt kódolót. Az érvényes értékek a következők:

- Szöveg: Szöveges üzenetkódoló használata.
- Mtom: Üzenetátviteli szervezeti mechanizmus 1.0 (MTOM) kódoló használata.

Az alapértelmezett szöveg. Ez az attribútum típusa WSMessageEncoding.
messageVersion Megadja a kötéssel konfigurált ügyfelek és szolgáltatások által használt üzenetverziót. Ez az attribútum típusa MessageVersion.
name A kötés konfigurációs nevét tartalmazó sztring. Ennek az értéknek egyedinek kell lennie, mert a kötés azonosításra szolgál. A .NET-keretrendszer 4-től kezdve a kötéseknek és a viselkedéseknek nem kell nevet adniuk. Az alapértelmezett konfigurációról és a névtelen kötésekről és viselkedésekről további információt a WCF-szolgáltatásokegyszerűsített konfigurációja és egyszerűsített konfigurációja című témakörben talál.
openTimeout Egy TimeSpan olyan érték, amely megadja a nyitott művelet végrehajtásához megadott időtartamot. Ennek az értéknek nagyobbnak vagy egyenlőnek Zerokell lennie. Az alapértelmezett érték 00:01:00.
proxyAddress A HTTP-proxy címét tartalmazó URI. Ha useSystemWebProxy be van állítva true, akkor ennek a beállításnak kell lennie null. Az alapértelmezett érték a null.
receiveTimeout A TimeSpan fogadási művelet végrehajtásához megadott időintervallumot meghatározó érték. Ennek az értéknek nagyobbnak vagy egyenlőnek Zerokell lennie. Az alapértelmezett érték 00:10:00.
sendTimeout A TimeSpan küldési művelet végrehajtásához megadott időintervallumot meghatározó érték. Ennek az értéknek nagyobbnak vagy egyenlőnek Zerokell lennie. Az alapértelmezett érték 00:01:00.
textEncoding Beállítja a karakterkészlet kódolását a kötésen lévő üzenetek kibocsátásához. Az érvényes értékek a következők:

- BigEndianUnicode: Unicode BigEndian kódolás.
- Unicode: 16 bites kódolás.
- UTF8: 8 bites kódolás

Az alapértelmezett érték az UTF8. Ez az attribútum típusa Encoding.
transferMode Érvényes TransferMode érték, amely meghatározza, hogy a rendszer puffereli vagy streameli-e az üzeneteket egy kérés vagy válasz alapján.
useDefaultWebProxy Logikai érték, amely meghatározza, hogy a rendszer automatikusan konfigurált HTTP-proxyját kell-e használni, ha van ilyen. Az alapértelmezett érték a true.

Gyermekelemek

Elem Description
<biztonság> Meghatározza a kötés biztonsági beállításait. Ez az elem típusa BasicHttpSecurityElement.
<readerQuotas> Meghatározza a SOAP-üzenetek összetettségére vonatkozó korlátozásokat, amelyeket az ezzel a kötéssel konfigurált végpontok feldolgozhatnak. Ez az elem típusa XmlDictionaryReaderQuotasElement.

Szülőelemek

Elem Description
<Kötések> Ez az elem szabványos és egyéni kötések gyűjteményét tartalmazza.

Megjegyzések

Ez a kötési elem egy védelmi szintet és egy cseremechanizmust biztosít a környezet részeként egy BasicHttpBinding.

Lásd még

  • Last updated on