<associazioneContestoHttpDiBase>

Articolo
09/12/2008

Specifica un'associazione che fornisce il contesto di scambio dell'associazione BasicHttpBinding mediante l'attivazione dei cookie HTTP come meccanismo di scambio.

<system.serviceModel>
<bindings>
<associazioneContestoHttpDiBase>

<basicHttpContextBinding>
   <binding 
       allowCookies="Boolean"
       bypassProxyOnLocal="Boolean"
       closeTimeout="TimeSpan" 
       envelopeVersion="None/Soap11/Soap12"
       hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
       maxBufferPoolSize="Integer"
       maxBufferSize="Integer"
       maxReceivedMessageSize="Integer"
       messageEncoding="Text/Mtom"
       name="string" 
       openTimeout="TimeSpan" 
       proxyAddress="URI"
       receiveTimeout="TimeSpan"
       sendTimeout="TimeSpan"
       textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
       transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
       useDefaultWebProxy="Boolean"
       <security mode="None/Transport/Message/TransportWithMessageCredential/TransportCredentialOnly">
           <transport clientCredentialType="None/Basic/Digest/Ntlm/Windows/Certificate"
                  proxyCredentialType="None/Basic/Digest/Ntlm/Windows"
                                    realm="string" />
           <message  algorithmSuite="Aes128/Aes192/Aes256/Rsa15Aes128/ Rsa15Aes256/TripleDes"
                                    clientCredentialType="UserName/Certificate"/>
       </security>
       <readerQuotas maxDepth="Integer" 
            maxStringContentLength="Integer"
            maxByteArrayContentLength="Integer"
            maxBytesPerRead="Integer"
            maxNameTableCharCount="Integer" />
   </binding>
</basicHttpContextBinding>

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 questo 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 gli indirizzi locali. L'impostazione predefinita è false. Una risorsa Internet è locale se dispone di un indirizzo locale. Un indirizzo locale è situato nello stesso computer, LAN o intranet locale ed è identificato nella sintassi dalla mancanza di un punto (.) come negli URI "http://webserver/" e "https://localhost/". L'impostazione di questo attributo determina se gli endpoint configurati con BasicHttpBinding utilizzano il server proxy quando accedono alle risorse locali. Se questo attributo è true, le richieste alle risorse Internet locali non utilizzano il server proxy. Quando l'attributo è impostato su true, utilizzare il nome host invece di localhost se si desidera che i client passino da un proxy per comunicare con servizi nello stesso computer. Se questo attributo è false, tutte le richieste Internet vengono effettuate tramite il server proxy.
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.
envelopeVersion	Specifica la versione di SOAP utilizzata per i messaggi elaborati da questa associazione. L'unico valore valido è Soap11.
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	Valore intero che specifica la quantità massima di memoria allocata al gestore dei buffer dei messaggi che riceve i messaggi dal canale. Il valore predefinito è 524288 (0x80000) byte. Il gestore dei buffer utilizza un pool di buffer per ridurre al minimo il costo legato all'utilizzo dei buffer. I buffer sono necessari per elaborare i messaggi provenienti dal servizio quando arrivano dal canale. Se la memoria nel pool di buffer non è sufficiente per elaborare il carico dei messaggi, il gestore dei buffer deve allocare altra memoria dall'heap CLR, aumentando l'overhead del processo di Garbage Collection. Se la quantità di memoria aggiuntiva allocata in questo modo è notevolmente elevata, ciò significa che le dimensioni del pool di buffer sono troppo ridotte e che per migliorare le prestazioni è possibile allocare più risorse a tale pool mediante l'aumento del limite specificato da questo attributo.
maxBufferSize	Un valore intero che specifica la dimensione massima, in byte, di un buffer che memorizza i messaggi mentre vengono elaborati per un endpoint configurato con questa associazione. Il valore predefinito è 65.536 byte.
maxReceivedMessageSize	Numero intero positivo che definisce la dimensione massima del messaggio, incluse le intestazioni, che può essere ricevuto in canale configurato con questa associazione. Il mittente riceve un errore SOAP se il messaggio è troppo grande per il destinatario. Il destinatario elimina il messaggio e crea una voce dell'evento nel registro di traccia. L'impostazione predefinita è 65.536 byte.
messageEncoding	Definisce il codificatore utilizzato per codificare il messaggio SOAP. Di seguito vengono elencati i valori validi: Text: utilizza un codificatore di messaggio di testo. Mtom: utilizza un codificatore Message Transmission Organization Mechanism 1.0 (MTOM). L'impostazione predefinita è Text. L'attributo è di tipo WSMessageEncoding.
messageVersion	Specifica la versione del messaggio utilizzata dai client e dai servizi configurati con l'associazione. L'attributo è di tipo MessageVersion.
name	Stringa che contiene il nome della configurazione dell'associazione. Questo valore deve essere univoco perché viene utilizzato per identificare l'associazione. Ciascuna associazione è provvista di un attributo name e namespace che insieme la identificano in modo univoco nei metadati del servizio. In aggiunta, il nome è univoco fra associazioni dello stesso tipo.
namespace	Specifica lo spazio dei nomi XML dell'associazione. Il valore predefinito è "http://tempuri.org/Bindings". Ciascuna associazione è provvista di un attributo name e namespace che insieme lo identificano in modo univoco nei metadati del servizio.
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 contiene l'indirizzo del proxy HTTP. Se useSystemWebProxy è impostato su true, questa impostazione deve essere null. L'impostazione predefinita è 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:10: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.
textEncoding	Imposta la codifica del set di caratteri da utilizzare per l'emissione dei messaggi nell'associazione. Di seguito vengono elencati i valori validi: BigEndianUnicode: codifica Unicode BigEndian. Unicode: codifica a 16 bit. UTF8: codifica a 8 bit L'impostazione predefinita è UTF8. L'attributo è di tipo Encoding.
transferMode	Valore TransferMode valido che specifica se i messaggi vengono memorizzati nel buffer o inviati nel flusso in una richiesta o una risposta.
useDefaultWebProxy	Valore booleano che specifica se il proxy HTTP configurato automaticamente del sistema deve essere utilizzato, se disponibile. L'impostazione predefinita è true.

Elementi figlio

Elemento	Descrizione
<security> di <basicHttpBinding>	Definisce le impostazioni di protezione per l'associazione. L'elemento è di tipo BasicHttpSecurityElement.
<quoteReader>	Definisce i vincoli sulla complessità dei messaggi SOAP che possono essere elaborati dagli endpoint configurati con questa associazione. L'elemento è di tipo XmlDictionaryReaderQuotasElement.

Elementi padre

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

Osservazioni

Questo elemento di associazione fornisce un livello di protezione e un meccanismo di scambio come parte del contesto per BasicHttpBinding.

Vedere anche

Riferimenti

<basicHttpBinding>
BasicHttpBinding
BasicHttpContextBinding
BasicHttpContextBindingElement
ContextBindingElement

Concetti

Altre risorse

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

Condividi tramite