<basicHttpContextBinding>

Artículo
10/07/2008

Especificar un enlace que proporciona el contexto para que BasicHttpBinding se intercambie habilitando las cookie de HTTP como el mecanismo de intercambio.

<<system.serviceModel>>
<enlaces>
<basicHttpContextBinding>

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

Atributos y elementos

Atributos

Atributo	Descripción
allowCookies	Un valor booleano que indica si el cliente acepta las cookies y las propaga en solicitudes futuras. El valor predeterminado es false. Puede utilizar esta propiedad al interactuar con los servicios web de ASMX que utilizan cookies. De esta manera, puede estar seguro de que las cookies devueltas del servidor se copian automáticamente en todas las solicitudes de cliente futuras para ese servicio.
bypassProxyOnLocal	Un valor booleano que indica si se omitirá el servidor proxy para las direcciones locales. El valor predeterminado es false. Un recurso de Internet es local si tiene una dirección local. Una dirección local se encuentra en el mismo equipo, la LAN local o intranet y se identifica, sintácticamente, por la falta de un período (.) como en el de URI y "https://localhost/" Al establecer este atributo se determina si los extremos configurados con BasicHttpBinding utilizan el servidor proxy al acceder a los recursos locales. Si este atributo es true, las solicitudes que se realicen en recursos locales de Internet no usarán el servidor proxy. Utilice el nombre de host (en lugar del host local) si desea que los clientes pasen por un proxy al hablar con los servicios del mismo equipo cuando este atributo está establecido en true. Cuando este atributo es false, todas las solicitudes de Internet se realizan a través del servidor proxy.
closeTimeout	Un valor TimeSpan que especifica el intervalo de tiempo de que dispone una operación de cierre para completarse. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00.
envelopeVersion	Especifica la versión de SOAP que se utiliza para los mensajes procesados por este enlace. El único valor válido es Soap11.
hostnameComparisonMode	Especifica el modo de comparación de nombres de host HTTP utilizado para analizar los URI. Este atributo es del tipo HostnameComparisonMode, que indica si se va a utilizar el nombre del host para llegar al servicio cuando coincida en el URI. El valor predeterminado es StrongWildcard, que omite el nombre del host en la coincidencia.
maxBufferPoolSize	Un valor entero que especifica la cantidad de memoria máxima que se asigna para el uso realizado por el administrador de los búferes que reciben los mensajes del canal. El valor predeterminado es 524288 (0x80000) bytes. El administrador de búfer reduce el coste de utilizar los búferes con un grupo de búferes. Es necesario que los búferes procesen los mensajes del servicio cuando salen del canal. Si no hay memoria suficiente en el grupo de búferes para procesar la carga de mensajes, el administrador de búfer debe asignar memoria adicional del montón CLR, que aumenta la carga de recolección de elementos no utilizados. La amplia asignación del montón de elementos no utilizados de CLR es una indicación de que el tamaño del grupo de búferes es demasiado pequeño y de que el rendimiento podría mejorar con una asignación mayor aumentando el límite especificado por este atributo.
maxBufferSize	Un valor entero que especifica el tamaño máximo, en bytes, de un búfer que almacena los mensajes mientras se procesan para un extremo configurado con este enlace. El valor predeterminado es 65.536 bytes.
maxReceivedMessageSize	Un entero positivo que define el tamaño máximo del mensaje, en bytes, incluidos los encabezados, para un mensaje que se puede recibir en un canal configurado con este enlace. El remitente recibe un error SOAP cuando el mensaje es demasiado grande para el receptor. El receptor elimina el mensaje y crea una entrada del evento en el registro de seguimiento. El valor predeterminado es 65.536 bytes.
messageEncoding	Define el codificador utilizado para codificar el mensaje SOAP. Los valores válidos son los siguientes: Text: utiliza un codificador de mensajes de texto. Mtom: utiliza un codificador de Mecanismo de optimización de transmisión del mensaje 1.0 (MTOM). El valor predeterminado es Text. Este atributo es del tipo WSMessageEncoding.
messageVersion	Especifica la versión del mensaje utilizada por los clientes y servicios configurados con el enlace. Este atributo es del tipo MessageVersion.
name	Cadena que contiene el nombre de la configuración del enlace. Este valor debe ser único porque se utiliza como identificador del enlace. Cada enlace tiene los atributos name y namespace que, juntos, lo identifican de forma exclusiva en los metadatos del servicio. Además, este nombre es único entre los enlaces del mismo tipo.
namespace	Especifica el espacio de nombres XML del enlace. El valor predeterminado es "http://tempuri.org/Bindings". Cada enlace tiene los atributos name y namespace que, juntos, lo identifican de forma exclusiva en los metadatos del servicio.
openTimeout	Un valor TimeSpan que especifica el intervalo de tiempo de que dispone una operación de apertura para completarse. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00.
proxyAddress	Un URI que contiene la dirección del proxy HTTP. Si useSystemWebProxy se establece en true, esta configuración debe ser null. El valor predeterminado es null.
receiveTimeout	Un valor TimeSpan que especifica el intervalo de tiempo de que dispone una operación de recepción para completarse. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:10:00.
sendTimeout	Un valor TimeSpan que especifica el intervalo de tiempo de que dispone una operación de envío para completarse. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00.
textEncoding	Establece el codificador del juego de caracteres que se va a usar para emitir los mensajes en el enlace. Los valores válidos son los siguientes: BigEndianUnicode: codificación Unicode BigEndian. Codificación de 16 bits Unicode. Codificación de 8 bits UTF8 El valor predeterminado es UTF8. Este atributo es del tipo Encoding.
transferMode	Un valor TransferMode válido que especifica si los mensajes se almacenan en búfer, se transmiten o si son una solicitud o una respuesta.
useDefaultWebProxy	Un valor booleano que especifica si se debería utilizar el proxy HTTP configurado automáticamente del sistema, si está disponible. El valor predeterminado es true.

Elementos secundarios

Elemento	Descripción
Elemento <security> de <basicHttpBinding>	Define la configuración de seguridad del enlace. Este elemento es del tipo BasicHttpSecurityElement.
<readerQuotas>	Define restricciones en la complejidad de los mensajes SOAP que pueden ser procesados por los puntos finales configurados con este enlace. Este elemento es del tipo XmlDictionaryReaderQuotasElement.

Elementos primarios

Elemento	Descripción
<enlaces>	Este elemento contiene una colección de enlaces estándar y personalizados. Su name único identifica cada entrada. Los servicios utilizan los enlaces vinculándose a ellos mediante su name.

Comentarios

Este elemento de enlace proporciona un nivel de protección y un mecanismo del intercambio como parte del contexto para BasicHttpBinding.

Consulte también

Referencia

<<basicHttpBinding>>
BasicHttpBinding
BasicHttpContextBinding
BasicHttpContextBindingElement
ContextBindingElement

Conceptos

Otros recursos

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

Share via