<associazioneHttpWeb>

  • Articolo

Definisce un elemento di associazione utilizzato per configurare endpoint per servizi Web Windows Communication Foundation (WCF) che rispondono a richieste HTTP anziché a messaggi SOAP.

<system.serviceModel>
  <bindings>
    <associazioneHttpWs>

<webHttpBinding>
    <binding 
        allowCookies="Boolean"
        bypassProxyOnLocal="Boolean"
        closeTimeout="TimeSpan"
        hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
        maxBufferPoolSize="integer"
        maxBufferSize="integer"
        maxReceivedMessageSize="Integer"
        name="string"
        openTimeout="TimeSpan" 
        proxyAddress="URI"
        receiveTimeout="TimeSpan"
        sendTimeout="TimeSpan"
                transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
        useDefaultWebProxy="Boolean">
                
writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
        <security mode="None/Transport/TransportCredentialOnly">
            <transport clientCredentialType = 
                 "Basic/Certificate/Digest/None/Ntlm/Windows"
                  proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                  realm="string" />
        </security>
        <readerQuotas maxArrayLength="integer"
           maxBytesPerRead="integer"
                      maxDepth="integer" 
           maxNameTableCharCount="integer"
           maxStringContentLength="integer" />
    </binding>
</webHttpBinding>

Attributi ed elementi

Attributi

Attributo Descrizione

allowCookies

Valore booleano che indica se il client accetta cookie e li propaga alle richieste future. L'impostazione predefinita è false.

È possibile utilizzare questa proprietà quando si interagisce con servizi Web ASMX che utilizzano cookie. In tal modo i cookie restituiti dal server vengono copiati automaticamente in tutte le richieste client future per quel servizio.

bypassProxyOnLocal

Valore booleano che indica se ignorare il server proxy per indirizzi locali. Il valore predefinito è false.

closeTimeout

Valore TimeSpan che specifica l'intervallo di tempo fornito 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. Questo attributo è di tipo HostnameComparisonMode, il quale indica se il nome host viene utilizzato per raggiungere il servizio in caso di corrispondenza dell'URI. Il valore predefinito è StrongWildcard, che ignora il nome host nella corrispondenza.

maxBufferPoolSize

Numero intero che specifica la dimensione del pool di buffer massima per questa associazione. Il valore predefinito è 524.288 byte (512 * 1024). Molte parti di Windows Communication Foundation (WCF) utilizzano buffer. La creazione e l'eliminazione dei buffer a ogni loro utilizzo sono operazioni onerose, come anche le procedure di Garbage Collection dei buffer. Quando si utilizza un pool di buffer è possibile prelevare un buffer dal pool, utilizzarlo e, al termine delle operazioni, riporlo nel pool. In questo modo è possibile evitare il sovraccarico dovuto alla creazione e all'eliminazione dei buffer.

maxBufferSize

Numero intero che specifica la quantità massima di memoria allocata al gestore dei buffer dei messaggi che riceve i messaggi dal canale. Il valore predefinito è 524,288 (0x80000) byte.

maxReceivedMessageSize

Numero intero positivo che specifica la dimensione massima del messaggio, incluse le intestazioni, che può essere ricevuto in canale configurato con questa associazione. Il mittente di un messaggio che supera questo limite riceverà un errore. Il destinatario elimina il messaggio e crea una voce dell'evento nel registro di traccia. L'impostazione predefinita è 65.536.

Nota

L'incremento di questo valore soltanto non è sufficiente in modalità di compatibilità ASP.NET. È necessario inoltre incrementare il valore di httpRuntime (vedere httpRuntime Element (ASP.NET Settings Schema)).

name

Stringa che contiene il nome della configurazione dell'associazione. Questo valore deve essere univoco perché viene utilizzato per identificare l'associazione.

openTimeout

Valore 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 e true, questa impostazione deve essere null. Il valore predefinito è null.

receiveTimeout

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

transferMode.

Valore TransferMode valido che indica se il servizio configurato con l'associazione utilizza modalità di trasferimento messaggi nel flusso o memorizzati nel buffer (o entrambe). Il valore predefinito è Buffered.

useDefaultWebProxy

Valore booleano che specifica se viene utilizzato il proxy HTTP di sistema configurato automaticamente. L'impostazione predefinita è true.

writeEncoding

Specifica la codifica dei caratteri utilizzata per il testo dei messaggi. Di seguito vengono elencati i valori validi:

UnicodeFffeTextEncoding: codifica Unicode BigEndian.

Utf16TextEncoding: codifica a 16 bit.

Utf8TextEncoding: codifica a 8 bit.

L'impostazione predefinita è Utf8TextEncoding.

Elementi figlio

Elemento Descrizione

<quoteReader>

Definisce i vincoli sulla complessità dei messaggi POX che possono essere elaborati dagli endpoint configurati con questa associazione. L'elemento è di tipo XmlDictionaryReaderQuotasElement.

<security> di <webHttpBinding>

Definisce le impostazioni di protezione per l'associazione. L'elemento è di tipo WSHttpSecurityElement.

Elementi padre

Elemento Descrizione

<bindings>

Questo elemento contiene un insieme di associazioni standard e personalizzate. Ciascuna voce è identificata dal relativo name. I servizi utilizzano le associazioni collegandole mediante il name.

Osservazioni

Il modello di programmazione Web di WCF consente agli sviluppatori di esporre servizi Web WCF tramite richieste HTTP che utilizzano messaggistica in stile POX (Plain Old XML) anziché messaggistica basata su SOAP. Per consentire ai client di comunicare con un servizio che utilizza richieste HTTP, un endpoint del servizio deve essere configurato con il <associazioneHttpWs> a cui è associato il <WebHttpBehavior>.

Il supporto della pubblicazione via RSS e dell'integrazione ASP.AJAX in WCF è integrato nel modello di programmazione Web. Per ulteriori informazioni sul modello, vedere Web Programming Model.

Vedere anche

Riferimenti

WebHttpBinding
WebHttpBindingElement

Concetti

<associazione>

Altre risorse

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