<basicHttpContextBinding><basicHttpContextBinding>

Specifica un'associazione che fornisce il contesto di scambio dell'associazione BasicHttpBinding mediante l'abilitazione dei cookie HTTP come meccanismo di scambio.Specifying a binding that provides context for the BasicHttpBinding to be exchanged by enabling HTTP cookies as the exchange mechanism.

<system.ServiceModel><system.ServiceModel>
<le associazioni ><bindings>
<basicHttpContextBinding><basicHttpContextBinding>

SintassiSyntax

<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             maxArrayLength="Integer"            maxBytesPerRead="Integer"            maxDepth="Integer"             maxNameTableCharCount="Integer"                     maxStringContentLength="Integer" />   </binding>  
</basicHttpContextBinding>  

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
allowCookies Valore booleano che indica se il client accetta cookie e li propaga alle richieste future.A Boolean value that indicates whether the client accepts cookies and propagates them on future requests. Il valore predefinito è false.The default is false.

È possibile usare questa proprietà quando si interagisce con servizi Web ASMX che usano cookie.You can use this property when you interact with ASMX Web services that use cookies. In questo modo i cookie restituiti dal server vengono copiati automaticamente in tutte le richieste client future per quel servizio.In this way, you can be sure that the cookies returned from the server are automatically copied to all future client requests for that service.
bypassProxyOnLocal Valore booleano che indica se ignorare il server proxy per indirizzi locali.A Boolean value that indicates whether to bypass the proxy server for local addresses. Il valore predefinito è false.The default is false.

Una risorsa Internet è locale se dispone di un indirizzo locale.An Internet resource is local if it has a local address. Un indirizzo locale è situato nello stesso computer, la LAN o intranet locale ed è identificato nella sintassi dalla mancanza di un punto (.) come URI "http://webserver/"e"http://localhost/".A local address is one that is on same computer, the local LAN or intranet and is identified, syntactically, by the lack of a period (.) as in the URIs "http://webserver/" and "http://localhost/".

L'impostazione di questo attributo determina se gli endpoint configurati con BasicHttpBinding usano il server proxy quando accedono alle risorse locali.Setting this attribute determines whether endpoints configured with the BasicHttpBinding use the proxy server when accessing local resources. Se questo attributo è true, le richieste alle risorse Internet locali non usano il server proxy.If this attribute is true, requests to local Internet resources do not use the proxy server. Quando l'attributo è impostato su true, usare il nome host invece di localhost se si desidera che i client passino da un proxy per comunicare con servizi nello stesso computer.Use the host name (rather than localhost) if you want clients to go through a proxy when talking to services on the same machine when this attribute is set to true.

Se questo attributo è false, tutte le richieste Internet vengono effettuate tramite il server proxy.When this attribute is false, all Internet requests are made through the proxy server.
closeTimeout Valore TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di chiusura.A TimeSpan value that specifies the interval of time provided for a close operation to complete. Questo valore deve essere maggiore o uguale a Zero.This value should be greater than or equal to Zero. L'impostazione predefinita è 00:01:00.The default is 00:01:00.
envelopeVersion Specifica la versione di SOAP usata per i messaggi elaborati da questa associazione.Specifies the version of SOAP that is used for messages that are processed by this binding. L'unico valore valido è Soap11.The only valid value is Soap11.
hostnameComparisonMode Specifica la modalità di confronto del nome host HTTP usata per analizzare gli URI.Specifies the HTTP hostname comparison mode used to parse URIs. L'attributo è di tipo HostNameComparisonMode, che indica se il nome host viene usato per raggiungere il servizio in caso di corrispondenza nell'URI.This attribute is of type HostNameComparisonMode, which indicates whether the hostname is used to reach the service when matching on the URI. Il valore predefinito è StrongWildcard, che ignora il nome host nella corrispondenza.The default value is StrongWildcard, which ignores the hostname in the match.
maxBufferPoolSize Valore intero che specifica la quantità massima di memoria allocata al gestore dei buffer dei messaggi che riceve i messaggi dal canale.An integer value that specifies the maximum amount of memory that is allocated for use by the manager of the message buffers that receive messages from the channel. Il valore predefinito è 524.288 (0x80000) byte.The default value is 524288 (0x80000) bytes.

Il gestore dei buffer usa un pool di buffer per ridurre al minimo il costo legato all'utilizzo dei buffer.The Buffer Manager minimizes the cost of using buffers by using a buffer pool. I buffer sono necessari per elaborare i messaggi provenienti dal servizio quando arrivano dal canale.Buffers are required to process messages by the service when they come out of the channel. 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 della procedura di Garbage Collection.If there is not sufficient memory in the buffer pool to process the message load, the Buffer Manager must allocate additional memory from the CLR heap, which increases the garbage collection overhead. 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.Extensive allocation from the CLR garbage heap is an indication that the buffer pool size is too small and that performance can be improved with a larger allocation by increasing the limit specified by this attribute.
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.An integer value that specifies the maximum size, in bytes, of a buffer that stores messages while they are processed for an endpoint configured with this binding. L'impostazione predefinita è 65.536 byte.The default value is 65,536 bytes.
maxReceivedMessageSize Numero intero positivo che definisce la dimensione massima del messaggio, incluse le intestazioni, che può essere ricevuto in canale configurato con questa associazione.A positive integer that defines the maximum message size, in bytes, including headers, for a message that can be received on a channel configured with this binding. Il mittente riceve un errore SOAP se il messaggio è troppo grande per il destinatario.The sender receives a SOAP fault if the message is too large for the receiver. Il destinatario elimina il messaggio e crea una voce dell'evento nel registro di traccia.The receiver drops the message and creates an entry of the event in the trace log. L'impostazione predefinita è 65.536 byte.The default is 65,536 bytes.
messageEncoding Definisce il codificatore usato per codificare il messaggio SOAP.Defines the encoder used to encode the SOAP message. Di seguito vengono elencati i valori validi:Valid values include the following:

-Text: Usa un codificatore di messaggi di testo.- Text: Use a text message encoder.
-Mtom: Usa un codificatore Message Transmission Organization meccanismo 1.0 (MTOM).- Mtom: Use a Message Transmission Organization Mechanism 1.0 (MTOM) encoder.

L'impostazione predefinita è Text.The default is Text. L'attributo è di tipo WSMessageEncoding.This attribute is of type WSMessageEncoding.
messageVersion Specifica la versione del messaggio usata dai client e dai servizi configurati con l'associazione.Specifies the message version used by clients and services configured with the binding. L'attributo è di tipo MessageVersion.This attribute is of type MessageVersion.
name Stringa che contiene il nome della configurazione dell'associazione.A string that contains the configuration name of the binding. Questo valore deve essere univoco perché viene usato per identificare l'associazione.This value should be unique because it is used as an identification for the binding. Ciascuna associazione è provvista di un attributo name e namespace che insieme la identificano in modo univoco nei metadati del servizio.Each binding has a name and namespace attribute that together uniquely identify it in the metadata of the service. In aggiunta, il nome è univoco fra associazioni dello stesso tipo.In addition, this name is unique among bindings of the same type. A partire da .NET Framework 4.NET Framework 4, non è necessario che le associazioni e i comportamenti dispongano di un nome.Starting with .NET Framework 4.NET Framework 4, bindings and behaviors are not required to have a name. Per ulteriori informazioni sulla configurazione predefinita e senza nome associazioni e comportamenti, vedere configurazione semplificata e configurazione semplificata per i servizi WCF.For more information about default configuration and nameless bindings and behaviors, see Simplified Configuration and Simplified Configuration for WCF Services.
namespace Specifica lo spazio dei nomi XML dell'associazione.Specifies the XML namespace of the binding. Il valore predefinito è "http://tempuri.org/Bindings".The default value is "http://tempuri.org/Bindings". Ciascuna associazione è provvista di un attributo name e namespace che insieme la identificano in modo univoco nei metadati del servizio.Each binding has a name and namespace attribute that together uniquely identify it in the metadata of the service.
openTimeout Valore TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di apertura.A TimeSpan value that specifies the interval of time provided for an open operation to complete. Questo valore deve essere maggiore o uguale a Zero.This value should be greater than or equal to Zero. L'impostazione predefinita è 00:01:00.The default is 00:01:00.
proxyAddress URI che contiene l'indirizzo del proxy HTTP.A URI that contains the address of the HTTP proxy. Se useSystemWebProxy è impostato su true, questa impostazione deve essere null.If useSystemWebProxy is set to true, this setting must be null. Il valore predefinito è null.The default is null.
receiveTimeout Valore TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di ricezione.A TimeSpan value that specifies the interval of time provided for a receive operation to complete. Questo valore deve essere maggiore o uguale a Zero.This value should be greater than or equal to Zero. L'impostazione predefinita è 00:10:00.The default is 00:10:00.
sendTimeout Valore TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di invio.A TimeSpan value that specifies the interval of time provided for a send operation to complete. Questo valore deve essere maggiore o uguale a Zero.This value should be greater than or equal to Zero. L'impostazione predefinita è 00:01:00.The default is 00:01:00.
textEncoding Imposta la codifica del set di caratteri da usare per l'emissione dei messaggi nell'associazione.Sets the character set encoding to be used for emitting messages on the binding. Di seguito vengono elencati i valori validi:Valid values include the following:

-BigEndianUnicode: Codifica Unicode BigEndian.- BigEndianUnicode: Unicode BigEndian encoding.
-Unicode: codifica a 16 bit.- Unicode: 16-bit encoding.
-UTF8: codifica a 8 bit- UTF8: 8-bit encoding

L'impostazione predefinita è UTF8.The default is UTF8. L'attributo è di tipo Encoding.This attribute is of type Encoding.
transferMode Valore TransferMode valido che specifica se i messaggi vengono memorizzati nel buffer o inviati nel flusso in una richiesta o una risposta.A valid TransferMode value that specifies whether messages are buffered or streamed on a request or response.
useDefaultWebProxy Valore booleano che specifica se il proxy HTTP configurato automaticamente del sistema deve essere usato, se disponibile.A Boolean value that specifies whether the auto-configured HTTP proxy of the system should be used, if available. Il valore predefinito è true.The default is true.

Elementi figlioChild Elements

ElementoElement DescrizioneDescription
<security><security> Definisce le impostazioni di sicurezza per l'associazione.Defines the security settings for the binding. L'elemento è di tipo BasicHttpSecurityElement.This element is of type BasicHttpSecurityElement.
<readerQuotas><readerQuotas> Definisce i vincoli sulla complessità dei messaggi SOAP che possono essere elaborati dagli endpoint configurati con questa associazione.Defines the constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding. L'elemento è di tipo XmlDictionaryReaderQuotasElement.This element is of type XmlDictionaryReaderQuotasElement.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
<bindings><bindings> Questo elemento contiene una raccolta di associazioni standard e personalizzate.This element holds a collection of standard and custom bindings.

NoteRemarks

Questo elemento di associazione fornisce un livello di protezione e un meccanismo di scambio come parte del contesto per BasicHttpBinding.This binding element provides a protection level and an exchange mechanism as part of the context for a BasicHttpBinding.

Vedere ancheSee Also

BasicHttpBinding
BasicHttpContextBinding
BasicHttpContextBindingElement
ContextBindingElement
AssociazioniBindings
Configurazione di associazioni fornite dal sistemaConfiguring System-Provided Bindings
Uso di associazioni per configurare i client e servizi Windows Communication FoundationUsing Bindings to Configure Windows Communication Foundation Services and Clients
<binding><binding>
<basicHttpBinding><basicHttpBinding>