<ws2007HttpBinding>

Articolo
09/12/2008

Definisce un'associazione interoperativa che fornisce il supporto per le versioni corrette degli elementi di associazione Security, ReliableSession e TransactionFlow.

<system.serviceModel>
<bindings>
<ws2007HttpBinding>

<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" 
           negotiateServiceCredential="Boolean"/>
        </security>
        <readerQuotas maxDepth="integer" 
           maxStringContentLength="integer"
                      maxArrayLength="integer"
           maxBytesPerRead="integer"
           maxNameTableCharCount="integer" />
    </binding>
</ws2007HttpBinding>

Attributi ed elementi

Attributi

Attributo	Descrizione
allowCookies	Valore che indica se il client accetta cookie e li propaga alle richieste future. Il valore predefinito è false. È possibile utilizzare questa proprietà quando si interagisce con servizi Web ASP.NET (ASMX) che utilizzano cookie. In questo modo i cookie restituiti dal server vengono copiati automaticamente in tutte le richieste client future per quel servizio.
bypassProxyOnLocal	Valore che indica se ignorare il server proxy per indirizzi locali. Il valore predefinito è false.
closeTimeout	Valore di TimeSpan che specifica l'intervallo di tempo per il completamento di un'operazione di chiusura. Questo valore deve essere maggiore o uguale a Zero. L'impostazione predefinita è 00:01:00.
hostnameComparisonMode	Specifica la modalità di confronto del nome host HTTP utilizzata per analizzare gli URI (Uniform Resource Identifier). Questo attributo è di tipo HostnameComparisonMode, che indica se il nome host viene utilizzato per raggiungere il servizio in caso di corrispondenza nell'URI. Il valore predefinito è StrongWildcard, che ignora il nome host nella corrispondenza.
maxBufferPoolSize	Dimensione massima del pool di buffer dell'associazione. Il valore predefinito è 524.288 byte (512 * 1.024). Molte parti di Windows Communication Foundation (WCF) utilizzano buffer. La creazione e l'eliminazione dei buffer a ogni utilizzo sono operazioni onerose, analogamente a quelle di Garbage Collection dei buffer. Quando si utilizza un pool di buffer è possibile prelevare un buffer dal pool, utilizzarlo e, al termine delle operazioni, reinserirlo nel pool. In questo modo è possibile evitare il sovraccarico dovuto alla creazione e all'eliminazione dei buffer.
maxReceivedMessageSize	Dimensione massima in byte del messaggio, incluse le intestazioni, che può essere ricevuta in un canale configurato con questa associazione. Il mittente di un messaggio che supera questo limite riceverà un errore SOAP. Il destinatario elimina il messaggio e crea una voce dell'evento nel log di analisi. L'impostazione predefinita è 65.536.
messageEncoding	Definisce il codificatore utilizzato per codificare il messaggio. Di seguito vengono elencati i valori validi: Text: utilizza un codificatore di messaggi di testo. Mtom: utilizza un codificatore Message Transmission Organization Mechanism 1.0 (MTOM). L'impostazione predefinita è Text. L'attributo è di tipo WSMessageEncoding.
name	Nome della configurazione dell'associazione. Questo valore deve essere univoco perché viene utilizzato per identificare l'associazione.
openTimeout	Valore di TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di apertura. Questo valore deve essere maggiore o uguale a Zero. L'impostazione predefinita è 00:01:00.
proxyAddress	URI che specifica l'indirizzo del proxy HTTP. Se useSystemWebProxy è true, questa impostazione deve essere null. L'impostazione predefinita è null.
receiveTimeout	Valore di TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di ricezione. Questo valore deve essere maggiore o uguale a Zero. L'impostazione predefinita è 00:01:00.
sendTimeout	Valore di TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di invio. Questo valore deve essere maggiore o uguale a Zero. L'impostazione predefinita è 00:01:00.
textEncoding	Specifica la codifica del set di caratteri da utilizzare per la creazione di messaggi nell'associazione. Di seguito vengono elencati i valori validi: UnicodeFffeTextEncoding: codifica Big-Endian Unicode a 16 bit. Utf16TextEncoding: codifica a 16 bit. Utf8TextEncoding: codifica a 8 bit. L'impostazione predefinita è Utf8TextEncoding. L'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 utilizzato il proxy HTTP di sistema configurato automaticamente. L'impostazione predefinita è true.

Elementi figlio

Elemento	Descrizione
<security> di <wsHttpBinding>	Definisce le impostazioni di sicurezza per l'associazione. L'elemento è di tipo WSHttpSecurityElement.
<quoteReader>	Definisce i vincoli sulla complessità dei messaggi SOAP che possono essere elaborati dagli endpoint configurati con questa associazione. L'elemento è di tipo XmlDictionaryReaderQuotasElement.
Elemento <reliableSession>	Specifica se vengono stabilite sessioni affidabili tra endpoint del canale.

Elementi padre

Elemento	Descrizione
<bindings>	Questo elemento contiene un insieme di associazioni standard e personalizzate. Ciascuna voce è identificata dal relativo oggetto name. I servizi utilizzano le associazioni collegandole mediante l'oggetto name.

Osservazioni

WS2007HttpBinding aggiunge un'associazione fornita dal sistema simile a WSHttpBinding, che tuttavia utilizza le versioni standard OASIS (Organization for the Advancement of Structured Information Standards (OASIS) dei protocolli ReliableSession, Security e TransactionFlow. Quando si utilizza questa associazione, non è necessario apportare modifiche al modello a oggetti o alle impostazioni predefinite.

Esempio

<configuration>
    <system.ServiceModel>
        <bindings>
            <ws2007HttpBinding>
                <binding name="test"
                    closeTimeout="00:00:10"
                    openTimeout="00:00:20" 
                    receiveTimeout="00:00:30"
                    sendTimeout="00:00:40"
                    bypassProxyOnLocal="false"
                    transactionFlow="false" 
                    hostNameComparisonMode="WeakWildcard"
                    maxMessageSize="1000"
                    messageEncoding="Mtom" 
                    proxyAddress="http://foo/bar"
                    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

Riferimenti

WS2007HttpBinding
WS2007HttpBindingElement

Concetti

Altre risorse

Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients

Condividi tramite