Condividi tramite

<ws2007HttpBinding>

Definisce un'associazione interoperabile che fornisce il supporto per le versioni corrette degli elementi di Securityassociazione , ReliableSessione TransactionFlow .

<configurazione>
   <system.serviceModel>
     <Associazioni>
       <ws2007HttpBinding>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributes

Attribute Description
allowCookies Valore che indica se il client accetta i cookie e li propaga alle richieste future. Il valore predefinito è false.

È possibile utilizzare questa proprietà quando si interagisce con ASP.NET servizi Web (ASMX) che usano cookie. In questo modo, i cookie restituiti dal server vengono copiati automaticamente in tutte le future richieste client per tale servizio.
bypassProxyOnLocal Valore che indica se ignorare il server proxy per gli indirizzi locali. Il valore predefinito è false.
closeTimeout Valore TimeSpan che specifica l'intervallo di tempo per il completamento di un'operazione di chiusura. Questo valore deve essere maggiore o uguale a Zero. Il valore predefinito è 00:01:00.
hostNameComparisonMode Specifica la modalità di confronto dei nomi host HTTP usata per analizzare gli URI (Uniform Resource Identifier). Questo attributo è di tipo HostNameComparisonMode, che indica se il nome host viene usato per raggiungere il servizio quando corrisponde all'URI. Il valore predefinito è StrongWildcard, che ignora il nome host nella corrispondenza.
maxBufferPoolSize Dimensioni massime del pool di buffer per questa associazione. Il valore predefinito è 524.288 byte (512 × 1.024). Molte parti di Windows Communication Foundation (WCF) usano buffer. La creazione e l'eliminazione di buffer ogni volta che vengono usati è costosa, come avviee per il Garbage Collection per i buffer. Con i pool di buffer, è possibile prendere un buffer dal pool, usarlo e restituirlo al pool al termine dell'operazione. In questo modo si evita il sovraccarico durante la creazione e l'eliminazione di buffer.
maxReceivedMessageSize Le dimensioni massime dei messaggi, in byte, incluse le intestazioni, che un canale configurato con questa associazione può ricevere. Il mittente di un messaggio che supera questo limite riceve un errore SOAP. Il ricevitore elimina il messaggio e crea una voce dell'evento nel log di traccia. Il valore predefinito è 65536.
messageEncoding Definisce il codificatore utilizzato per codificare il messaggio. I valori validi includono quanto segue:

- Text: usare un codificatore di messaggi di testo.
- Mtom: usare un codificatore MTOM (Message Transmission Organization Mechanism 1.0).

Il valore predefinito è Text.

Questo attributo è di tipo WSMessageEncoding.
name Nome della configurazione dell'associazione. Questo valore deve essere univoco perché viene usato come identificazione per l'associazione. A partire da .NET Framework 4, le associazioni e i comportamenti non devono avere un nome. Per altre informazioni sulla configurazione predefinita e sui comportamenti senza nome, vedere Configurazione semplificata e configurazione semplificata per i servizi WCF.
openTimeout Valore TimeSpan che specifica l'intervallo di tempo specificato per il completamento di un'operazione aperta. Questo valore deve essere maggiore o uguale a Zero. Il valore predefinito è 00:01:00.
proxyAddress URI che specifica l'indirizzo del proxy HTTP. Se useSystemWebProxy è true, questa impostazione deve essere null. Il valore predefinito è null.
receiveTimeout Valore TimeSpan che specifica l'intervallo di tempo specificato per il completamento di un'operazione di ricezione. Questo valore deve essere maggiore o uguale a Zero. Il valore predefinito è 00:01:00.
sendTimeout Valore TimeSpan che specifica l'intervallo di tempo specificato per il completamento di un'operazione di invio. Questo valore deve essere maggiore o uguale a Zero. Il valore predefinito è 00:01:00.
textEncoding Specifica la codifica del set di caratteri da utilizzare per l'emissione di messaggi nell'associazione. I valori validi includono quanto segue:

- UnicodeFffeTextEncoding: codifica Big Endian Unicode.
- Utf16TextEncoding: codifica a 16 bit.
- Utf8TextEncoding: codifica a 8 bit.

Il valore predefinito è Utf8TextEncoding.

Questo attributo è di tipo Encoding.
transactionFlow Valore che specifica se l'associazione supporta il flusso di WS-Transactions. Il valore predefinito è false.
useDefaultWebProxy Valore che specifica se viene usato il proxy HTTP configurato automaticamente dal sistema. Il valore predefinito è true.

Elementi figli

Elemento Description
<sicurezza> Definisce le impostazioni di sicurezza per l'associazione. Questo elemento è di tipo WSHttpSecurityElement.
<readerQuotas> Definisce i vincoli sulla complessità dei messaggi SOAP che gli endpoint configurati con questa associazione possono elaborare. Questo elemento è di tipo XmlDictionaryReaderQuotasElement.
<ReliableSession> Specifica se vengono stabilite sessioni affidabili tra gli endpoint del canale.

Elementi padre

Elemento Description
<Associazioni> Questo elemento contiene una raccolta di associazioni standard e personalizzate.

Osservazioni:

Aggiunge WS2007HttpBinding un'associazione fornita dal sistema simile a WSHttpBinding ma usa le versioni standard Oasis (Organization for the Advancement of Structured Information Standards) dei protocolli ReliableSession, Security e TransactionFlow. Quando si usa questa associazione non sono necessarie modifiche al modello a oggetti o alle impostazioni predefinite.

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>

Vedere anche

  • Last updated on