Dela via

<wsDualHttpBinding>

Definierar en säker, tillförlitlig och samverkande bindning som är lämplig för duplex-tjänstkontrakt eller kommunikation via SOAP-mellanhänder.

<Konfiguration>
   <system.serviceModel>
     <Bindningar>
       <wsDualHttpBinding>

Syntax

<wsDualHttpBinding>
  <binding name="String"
          closeTimeout="TimeSpan"
          openTimeout="TimeSpan"
          receiveTimeout="TimeSpan"
          sendTimeout="TimeSpan"
          bypassProxyOnLocal="Boolean"
          clientBaseAddress="URI"
          transactionFlow="Boolean"
          hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
          maxBufferPoolSize="integer"
          maxReceivedMessageSize="Integer"
          messageEncoding="Text/Mtom"
          proxyAddress="URI"
          textEncoding="Unicode/BigEndianUnicode/UTF8"
          useDefaultWebProxy="Boolean">
    <reliableSession ordered="Boolean"
                     inactivityTimeout="TimeSpan" />
    <security mode="None/Message">
      <message clientCredentialType="None/Windows/UserName/Certificate/CardSpace"
               negotiateServiceCredential="Boolean"
               algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</wsDualHttpBinding>

Attribut och element

Följande avsnitt beskriver attribut, underordnade element och överordnade element

Attribut

Attribut Beskrivning
bypassProxyOnLocal Ett booleskt värde som anger om proxyservern ska kringgås för lokala adresser. Standardvärdet är false.
clientBaseAddress En URI som anger den basadress som klienten lyssnar efter svarsmeddelanden från tjänsten. Om det anges används den här adressen (plus en per channelGUID) för att lyssna. Om värdet inte anges genereras klientens basadress på ett transportspecifikt sätt. Standardvärdet är null.
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 heltal som anger den maximala buffertpoolstorleken för den här bindningen. Standardvärdet är 524 288 byte (512 * 1024). Många delar av Windows Communication Foundation (WCF) använder buffertar. Att skapa och förstöra buffertar varje gång de används är dyrt, och skräpinsamling för buffertar är också dyrt. Med buffertpooler kan du ta en buffert från poolen, använda den och returnera den till poolen när du är klar. Därmed undviks kostnaden för att skapa och förstöra buffertar.
maxReceivedMessageSize Ett positivt heltal som anger den maximala meddelandestorleken i byte, inklusive rubriker, som kan tas emot på en kanal som konfigurerats med den här bindningen. Avsändaren av ett meddelande som överskrider den här gränsen får ett SOAP-fel. Mottagaren släpper meddelandet och skapar en post för händelsen i spårningsloggen. Standardvärdet är 65536.
messageEncoding Definierar kodaren som används för att koda 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.
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 anger adressen till HTTP-proxyn. Om useDefaultWebProxy är 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:01: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.
textKodning 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.
transactionFlow Ett booleskt värde som anger om bindningen stöder flödande WS-transaktioner. Standardvärdet är false.
useDefaultWebProxy Ett booleskt värde som anger om systemets automatiskt konfigurerade HTTP-proxy används. Proxyadressen måste vara null (dvs. inte inställd) om det här attributet är true. Standardvärdet är true.

Underordnade element

Element Beskrivning
<Säkerhet> Definierar säkerhetsinställningarna för bindningen. Det här elementet är av typen WSDualHttpSecurityElement.
<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.
<reliableSession> Anger om tillförlitliga sessioner upprättas mellan kanalslutpunkter.

Överordnade element

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

Kommentarer

WSDualHttpBinding Ger samma stöd för Webbtjänstprotokoll som WSHttpBinding, men för användning med duplex-kontrakt. WSDualHttpBinding stöder endast SOAP-säkerhet och kräver tillförlitliga meddelanden. Den här bindningen kräver att klienten har en offentlig URI som tillhandahåller en återanropsslutpunkt för tjänsten. Detta tillhandahålls av attributet clientBaseAddress . En dubbel bindning exponerar KLIENTENs IP-adress för tjänsten. Klienten bör använda säkerhet för att säkerställa att den bara ansluter till tjänster som den litar på.

Den här bindningen kan användas för att kommunicera tillförlitligt via en eller flera SOAP-mellanhänder.

Som standard genererar den här bindningen en körningsstack med WS-ReliableMessaging för tillförlitlighet, WS-Security för meddelandesäkerhet och autentisering, HTTP för meddelandeleverans och kodning av text-/XML-meddelanden.

Exempel

<configuration>
  <system.ServiceModel>
    <bindings>
      <wsDualHttpBinding>
        <binding closeTimeout="00:00:10"
                 openTimeout="00:00:20"
                 receiveTimeout="00:00:30"
                 sendTimeout="00:00:40"
                 bypassProxyOnLocal="false"
                 clientBaseAddress="http://localhost:8001/client/"
                 transactionFlow="true"
                 hostNameComparisonMode="WeakWildcard"
                 maxReceivedMessageSize="1000"
                 messageEncoding="Mtom"
                 proxyAddress="http://foo/bar"
                 textEncoding="utf-16"
                 useDefaultWebProxy="false">
          <reliableSession ordered="false"
                           inactivityTimeout="00:02:00" />
          <security mode="None">
            <message clientCredentialType="None"
                     negotiateServiceCredential="false"
                     algorithmSuite="Aes128" />
          </security>
        </binding>
      </wsDualHttpBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

Se även