<trasportoHttp>

Specifica un trasporto HTTP per la trasmissione di messaggi SOAP per un'associazione personalizzata.

Gerarchia dello schema

<system.serviceModel>
  <bindings>
    <associazionePersonalizzata>
      <binding>
        <trasportoHttp>

Sintassi

<httpTransport
    allowCookies=Boolean"
    authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
    bypassProxyOnLocal=Boolean"
    hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
    keepAliveEnabled="Boolean"
    maxBufferSize="Integer"
    proxyAddress="Uri"
    proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    realm="String"
    transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
        unsafeConnectionNtlmAuthentication="Boolean"
        useDefaultWebProxy="Boolean" />

Attributi ed elementi

Nelle sezioni seguenti vengono descritti attributi, elementi figlio ed elementi padre.

Attributi

Attributo	Descrizione
allowCookies	Valore booleano che specifica se il client accetta cookie e li propaga alle richieste future. Il valore predefinito è false. È possibile utilizzare questo attributo quando si interagisce con servizi Web ASMX che utilizzano cookie. In questo modo i cookie restituiti dal server vengono copiati automaticamente in tutte le richieste client future per quel servizio.
authenticationScheme	Specifica il protocollo utilizzato per autenticare le richieste del client elaborate da un listener HTTP. Di seguito vengono elencati i valori validi: Digest: specifica l'autenticazione digest. Negotiate: negozia con il client per determinare lo schema di autenticazione. Viene utilizzato se il client e il server supportano entrambi Kerberos; in caso contrario, viene utilizzato NTLM. Ntlm: specifica l'autenticazione NTLM. Basic: specifica l'autenticazione di base. Anonymous: specifica l'autenticazione anonima. Il valore predefinito è Anonymous. L'attributo è di tipo AuthenticationSchemes. Questo attributo può essere impostato solo una volta.
bypassProxyOnLocal	Valore booleano che indica se ignorare il server proxy per indirizzi locali. Il valore predefinito è false. Un indirizzo locale corrisponde a un indirizzo che si trova nella rete LAN o nell'Intranet locale. Windows Communication Foundation (WCF) ignora sempre il proxy se l'indirizzo del servizio inizia con https://localhost. È necessario utilizzare il nome host invece di localhost se si desidera che i client passino da un proxy quando comunicano con servizi nello stesso computer.
hostnameComparisonMode	Specifica la modalità di confronto del nome host HTTP utilizzata per analizzare gli URI. I valori validi sono: StrongWildcard: ("+") corrisponde tutti i possibili nomi host nel contesto dello schema, porta e relativo URI specificati. Exact: caratteri jolly non utilizzati WeakWildcard: ("*") corrisponde a qualsiasi nome host possibile nel contesto dello schema, porta e relativo UIR specificati che non ha trovato una corrispondenza esplicita o tramite il meccanismo sicuro dei caratteri jolly. L'impostazione predefinita è StrongWildcard. L'attributo è di tipo HostnameComparisonMode.
keepAliveEnabled	Valore booleano che specifica se eseguire una connessione permanente alla risorsa Internet.
maxBufferSize	Numero intero positivo che specifica la dimensione massima del buffer. L'impostazione predefinita è 524288.
proxyAddress	URI che specifica l'indirizzo del proxy HTTP. Se useSystemWebProxy è true, questa impostazione deve essere null. Il valore predefinito è null.
proxyAuthenticationScheme	Specifica il protocollo utilizzato per l'autenticazione delle richieste client elaborate da un proxy HTTP. Di seguito vengono elencati i valori validi: None: non viene eseguita alcuna autenticazione. Digest: specifica l'autenticazione digest. Negotiate: negozia con il client per determinare lo schema di autenticazione. Viene utilizzato se il client e il server supportano entrambi Kerberos; in caso contrario, viene utilizzato NTLM. Ntlm: specifica l'autenticazione NTLM. Basic: specifica l'autenticazione di base. Anonymous: specifica l'autenticazione anonima. IntegratedWindowsAuthentication: specifica l'autenticazione di Windows. Il valore predefinito è Anonymous. L'attributo è di tipo AuthenticationSchemes.
realm	Stringa che specifica l'area di autenticazione da utilizzare sul proxy/server. Il valore predefinito è una stringa vuota. I server utilizzano aree di autenticazione per separare risorse protette. Ogni partizione può avere schema di autenticazione e/o database di autorizzazione propri. Le aree vengono utilizzate solo per l'autenticazione di base e classificata. Se un client viene autenticato correttamente, l'autenticazione è valida per tutte le risorse in una determinata area. Per una descrizione dettagliata delle aree, vedere RFC 2617 all'indirizzo http://www.ietf.org.
transferMode	Specifica se i messaggi vengono memorizzati nel buffer o inviati nel flusso in una richiesta o una risposta. Di seguito vengono elencati i valori validi: Buffered: i messaggi di richiesta e risposta vengono memorizzati nel buffer. Streamed: i messaggi di richiesta e risposta vengono inviati nel flusso. StreamedRequest: il messaggio di richiesta viene inviato nel flusso e quello di risposta viene memorizzato nel buffer. StreamedResponse: il messaggio di richiesta viene memorizzato nel buffer e quello di risposta viene inviato nel flusso. L'impostazione predefinita è Buffered. L'attributo è di tipo TransferMode.
unsafeConnectionNtlmAuthentication	Valore che specifica se nel server viene attivata la condivisione di connessioni non sicure. Il valore predefinito è false. Se attivata, l'autenticazione NTLM viene eseguita una volta su ogni connessione TCP.
useDefaultWebProxy	Valore booleano che specifica se vengono utilizzate le impostazioni proxy a livello di computer anziché le impostazioni utente specifiche. Il valore predefinito è true.

Elementi figlio

Nessuno

Elementi padre

Elemento	Descrizione
<binding>	Definisce tutte le funzionalità di associazione dell'associazione personalizzata.

Osservazioni

L'elemento httpTransport rappresenta il punto iniziale per la creazione di un'associazione personalizzata che implementa il protocollo di trasporto HTTP. Quest'ultimo è il principale trasporto utilizzato per scopi di interoperabilità. Questo trasporto è supportato da Windows Communication Foundation (WCF) per assicurare l'interoperabilità con altri stack di servizi Web diversi da WCF.

Vedere anche

Riferimento

<associazionePersonalizzata>
HttpTransportElement
HttpTransportBindingElement
TransportBindingElement
CustomBinding

Altre risorse

Transports in Windows Communication Foundation
Choosing a Transport
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings