<webHttpBinding>

Artículo
10/07/2008

Define un elemento de enlace que se utiliza para configurar los extremos para los servicios web Windows Communication Foundation (WCF) que responden a las solicitudes HTTP en lugar de los mensajes SOAP.

<<system.serviceModel>>
<enlaces>
<<wsHttpBinding>>

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

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.
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.
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	Entero que especifica el tamaño máximo del grupo de búferes para este enlace. El valor predeterminado es 524.288 bytes (512x1024). En muchas partes de Windows Communication Foundation (WCF) se utilizan búferes. Crear y destruir búferes cada vez que se usan es caro, y la recopilación de elementos no utilizados para los búferes también es cara. Con grupos de búferes, puede tomar un búfer del grupo, usarlo y devolverlo al grupo una vez haya terminado. Así se evitan los gastos generales al crear y destruir búferes.
maxBufferSize	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 524.288 (0x80000) bytes.
maxReceivedMessageSize	Entero positivo que especifica el tamaño máximo del mensaje, en bytes, incluidos los encabezados, que se puede recibir en un canal configurado con este enlace. El remitente de un mensaje que supere este límite recibirá un error. El receptor elimina el mensaje y crea una entrada del evento en el registro de seguimiento. El valor predeterminado es 65536. Nota: No basta con aumentar este valor en el modo compatible de ASP.NET. También debe aumentar el valor de httpRuntime (vea httpRuntime Element (ASP.NET Settings Schema)).
name	Cadena que contiene el nombre de la configuración del enlace. Este valor debe ser único porque se utiliza como identificador del enlace.
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 especifica la dirección del proxy HTTP. Si useSystemWebProxy es true, este valor 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:01: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.
transferMode.	Un valor TransferMode que indica si el servicio configurado con el enlace utiliza modos de transmisión o de almacenamiento en búfer (o ambos) de transferencia de mensaje. El valor predeterminado es Buffered.
useDefaultWebProxy	Un valor booleano que especifica si se utiliza el proxy HTTP del sistema configurado automáticamente. El valor predeterminado es true.
writeEncoding	Especifica la codificación de caracteres que se usa para el texto del mensaje. Los valores válidos son los siguientes: UnicodeFffeTextEncoding: codificación de BigEndian de Unicode. Utf16TextEncoding: codificación de 16 bits. Utf8TextEncoding: codificación de 8 bits. El valor predeterminado es Utf8TextEncoding.

Elementos secundarios

Elemento	Descripción
<readerQuotas>	Define restricciones en la complejidad de los mensajes POX que pueden ser procesados por los extremos configurados con este enlace. Este elemento es del tipo XmlDictionaryReaderQuotasElement.
<security> de <webHttpBinding>	Define la configuración de seguridad del enlace. Este elemento es del tipo WSHttpSecurityElement.

Elementos primarios

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

Comentarios

El modelo de programación web WCF permite a los programadores exponer los servicios web WCF a través de las solicitudes HTTP que utilizan la "mensajería de estilo llana de XML (POX)" anterior en lugar de la mensajería basada en SOAP. Para comunicar con un servicio utilizando las solicitudes HTTP, un extremo del servicio se debe configurar con <<wsHttpBinding>> que tiene <WebHttpBehavior> asociado a él para los clientes.

La compatibilidad WCF para la sindicación e integración de ASP.AJAX se encuentra integrada en el Modelo de programación web. Para obtener más información sobre este modelo, vea Web Programming Model.

Consulte también

Referencia

WebHttpBinding
WebHttpBindingElement

Conceptos

Otros recursos

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

Share via