Condividi tramite

<webHttpBinding>

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

<configurazione>
   <system.serviceModel>
     <Associazioni>
       <webHttpBinding>

Sintassi

<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

Le sezioni seguenti descrivono gli attributi, gli elementi figlio e gli elementi padre

Attributes

Attribute Description
allowCookies Valore booleano 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 i servizi Web ASMX che usano i cookie. In questo modo, è possibile assicurarsi che i cookie restituiti dal server vengano copiati automaticamente in tutte le future richieste client per tale servizio.
bypassProxyOnLocal Valore booleano che indica se ignorare il server proxy per gli indirizzi locali. Il valore predefinito è false.
closeTimeout Valore TimeSpan che specifica l'intervallo di tempo specificato 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. 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 Intero che specifica le dimensioni massime del pool di buffer per questa associazione. Il valore predefinito è 524.288 byte (512 * 1024). Molte parti di Windows Communication Foundation (WCF) usano buffer. La creazione e l'eliminazione di buffer ogni volta che vengono usati è costosa e anche l'operazione di Garbage Collection per i buffer è costosa. Con i pool di buffer, è possibile recuperare un buffer dal pool, usarlo e restituirlo al pool al termine dell'operazione. Pertanto, viene evitato il sovraccarico nella creazione e nell'eliminazione dei buffer.
maxBufferSize Intero che specifica la quantità massima di memoria allocata per l'uso da parte del gestore dei buffer dei messaggi che ricevono messaggi dal canale. Il valore predefinito è 524.288 (0x80000) byte.
maxReceivedMessageSize Intero positivo che specifica le dimensioni massime del messaggio, in byte, incluse le intestazioni, che possono essere ricevute in un canale configurato con questa associazione. Il mittente di un messaggio che supera questo limite riceverà un errore. Il ricevitore elimina il messaggio e crea una voce dell'evento nel log di traccia. Il valore predefinito è 65536. Nota: L'aumento di questo valore da solo non è sufficiente in ASP.NET modalità compatibile. È anche consigliabile aumentare il valore di httpRuntime (vedere elemento httpRuntime (schema delle impostazioni di ASP.NET).
nome Stringa contenente il nome di 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.
Transfermode. Valore TransferMode che indica se il servizio configurato con l'associazione usa modalità di trasferimento dei messaggi memorizzate nel flusso o memorizzate nel buffer (o in entrambe le modalità). Il valore predefinito è Buffered.
useDefaultWebProxy Valore booleano che specifica se viene usato il proxy HTTP configurato automaticamente dal sistema. Il valore predefinito è true.
writeEncoding Specifica la codifica dei caratteri utilizzata per il testo del messaggio. I valori validi includono quanto segue:

UnicodeFffeTextEncoding: codifica Unicode BigEndian.

Utf16TextEncoding: codifica a 16 bit.

Utf8TextEncoding: codifica a 8 bit.

Il valore predefinito è Utf8TextEncoding.

Elementi figli

Elemento Description
<readerQuotas> Definisce i vincoli sulla complessità dei messaggi POX che possono essere elaborati dagli endpoint configurati con questa associazione. Questo elemento è di tipo XmlDictionaryReaderQuotasElement.
<sicurezza> Definisce le impostazioni di sicurezza per l'associazione. Questo elemento è di tipo WebHttpSecurityElement.

Elementi padre

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

Osservazioni:

Il modello di programmazione Web WCF consente agli sviluppatori di esporre i servizi Web WCF tramite richieste HTTP che usano la messaggistica di tipo "XML normale" (POX) anziché la messaggistica basata su SOAP. Per consentire ai client di comunicare con un servizio tramite richieste HTTP, è necessario configurare un endpoint del servizio con <webHttpBinding> a <cui è associato WebHttpBehavior> .

Supporto in WCF per la diffusione e ASP. L'integrazione AJAX è basata sul modello di programmazione Web. Per altre informazioni sul modello, vedere Wcf Web HTTP Programming Model.

Vedere anche

  • Last updated on