<webHttpBinding ><webHttpBinding>

Define un elemento de enlace que se utiliza para configurar los extremos de los servicios Web de Windows Communication Foundation (WCF) que responden a las solicitudes HTTP en lugar de a los mensajes SOAP.Defines a binding element that is used to configure endpoints for Windows Communication Foundation (WCF) Web services that respond to HTTP requests instead of SOAP messages.

<configuration> <configuration>
   <> System. serviceModel  <system.serviceModel>
    <enlaces >    <bindings>
       <webHttpBinding >      <webHttpBinding>

SintaxisSyntax

<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 elementosAttributes and Elements

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primariosThe following sections describe attributes, child elements, and parent elements

AtributosAttributes

AtributoAttribute DescripciónDescription
allowCookiesallowCookies Valor de tipo booleano que indica si el cliente acepta las cookies y las propaga en solicitudes futuras.A Boolean value that indicates whether the client accepts cookies and propagates them on future requests. El valor predeterminado es false.The default is false.

Puede utilizar esta propiedad al interactuar con los servicios Web ASMX que utilizan cookies.You can use this property when you interact with ASMX Web services that use 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.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.
bypassProxyOnLocalbypassProxyOnLocal Valor de tipo booleano que indica si se omitirá el servidor proxy para las direcciones locales.A Boolean value that indicates whether to bypass the proxy server for local addresses. De manera predeterminada, es false.The default is false.
closeTimeoutcloseTimeout Un valor TimeSpan que especifica el intervalo de tiempo del que dispone una operación de cierre para completarse.A TimeSpan value that specifies the interval of time provided for a close operation to complete. Este valor debe ser mayor o igual que Zero.This value should be greater than or equal to Zero. El valor predeterminado es 00:01:00.The default is 00:01:00.
hostnameComparisonModehostnameComparisonMode Especifica el modo de comparación de nombres de host HTTP usado para analizar los URI.Specifies the HTTP hostname comparison mode used to parse URIs. 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.This attribute is of type HostNameComparisonMode, which indicates whether the hostname is used to reach the service when matching on the URI. El valor predeterminado es StrongWildcard, que omite el nombre del host en la coincidencia.The default value is StrongWildcard, which ignores the hostname in the match.
maxBufferPoolSizemaxBufferPoolSize Entero que especifica el tamaño máximo del grupo de búferes para este enlace.An integer that specifies the maximum buffer pool size for this binding. El valor predeterminado es 524.288 bytes (512x1024).The default is 524,288 bytes (512 * 1024). En muchas partes de Windows Communication Foundation (WCF) se utilizan búferes.Many parts of Windows Communication Foundation (WCF) use buffers. Crear y destruir búferes cada vez que se usan es caro, y la recolección de elementos no utilizados para los búferes también es cara.Creating and destroying buffers each time they are used is expensive, and garbage collection for buffers is also expensive. Con grupos de búferes, puede tomar un búfer del grupo, usarlo y devolverlo al grupo una vez haya terminado.With buffer pools, you can take a buffer from the pool, use it, and return it to the pool once you are done. Así se evita la sobrecarga al crear y destruir búferes.Thus the overhead in creating and destroying buffers is avoided.
maxBufferSizemaxBufferSize 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.An integer 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. El valor predeterminado es 524.288 (0x80000) bytes.The default value is 524,288 (0x80000) bytes.
maxReceivedMessageSizemaxReceivedMessageSize 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.A positive integer that specifies the maximum message size, in bytes, including headers, that can be received on a channel configured with this binding. El remitente de un mensaje que supere este límite recibirá un error.The sender of a message exceeding this limit will receive a fault. El destinatario quita el mensaje y crea una entrada del evento en el registro de seguimiento.The receiver drops the message and creates an entry of the event in the trace log. El valor predeterminado es 65536.The default is 65536. Nota: Aumentar este valor por sí solo no es suficiente en el modo compatible con ASP.NET.Note: Increasing this value alone is not sufficient in ASP.NET compatible mode. También debe aumentar el valor de httpRuntime (vea Elemento httpRuntime (esquema de configuración de ASP.net)).You should also increase the value of httpRuntime (see httpRuntime Element (ASP.NET Settings Schema)).
namename Cadena que contiene el nombre de configuración del enlace.A string that contains the configuration name of the binding. Este valor debe ser único porque se usa como identificación del enlace.This value should be unique because it is used as an identification for the binding. A partir de .NET Framework 4, no es necesario que los enlaces y los comportamientos tengan un nombre.Starting with .NET Framework 4, bindings and behaviors are not required to have a name. Para obtener más información sobre la configuración predeterminada y los enlaces y comportamientos sin nombre, vea configuración simplificada y configuración simplificada para servicios WCF.For more information about default configuration and nameless bindings and behaviors, see Simplified Configuration and Simplified Configuration for WCF Services.
openTimeoutopenTimeout Valor de la estructura TimeSpan que especifica el intervalo de tiempo del que dispone una operación de apertura para completarse.A TimeSpan value that specifies the interval of time provided for an open operation to complete. Este valor debe ser mayor o igual que Zero.This value should be greater than or equal to Zero. El valor predeterminado es 00:01:00.The default is 00:01:00.
proxyAddressproxyAddress Un URI que especifica la dirección del proxy HTTP.A URI that specifies the address of the HTTP proxy. Si useSystemWebProxy es true, este valor debe ser null.If useSystemWebProxy is true, this setting must be null. De manera predeterminada, es null.The default is null.
receiveTimeoutreceiveTimeout Un valor TimeSpan que especifica el intervalo de tiempo del que dispone una operación de recepción para completarse.A TimeSpan value that specifies the interval of time provided for a receive operation to complete. Este valor debe ser mayor o igual que Zero.This value should be greater than or equal to Zero. El valor predeterminado es 00:01:00.The default is 00:01:00.
sendTimeoutsendTimeout Un valor TimeSpan que especifica el intervalo de tiempo del que dispone una operación de envío para completarse.A TimeSpan value that specifies the interval of time provided for a send operation to complete. Este valor debe ser mayor o igual que Zero.This value should be greater than or equal to Zero. El valor predeterminado es 00:01:00.The default is 00:01:00.
transferMode.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.A TransferMode value that indicates whether the service configured with the binding uses streamed or buffered (or both) modes of message transfer. De manera predeterminada, es Buffered.The default is Buffered.
useDefaultWebProxyuseDefaultWebProxy Valor de tipo booleano que especifica si se utiliza el proxy HTTP del sistema configurado automáticamente.A Boolean value that specifies whether the system’s auto-configured HTTP proxy is used. De manera predeterminada, es true.The default is true.
writeEncodingwriteEncoding Especifica la codificación de caracteres que se usa para el texto del mensaje.Specifies the character encoding that is used for the message text. Los valores válidos son los siguientes:Valid values include the following:

UnicodeFffeTextEncoding: codificación de BigEndian de Unicode.UnicodeFffeTextEncoding: Unicode BigEndian encoding.

Utf16TextEncoding: codificación de 16 bits.Utf16TextEncoding: 16-bit encoding.

Utf8TextEncoding: codificación de 8 bits.Utf8TextEncoding: 8-bit encoding.

El valor predeterminado es Utf8TextEncoding.The default is Utf8TextEncoding.

Elementos secundariosChild Elements

ElementoElement DescripciónDescription
<readerQuotas ><readerQuotas> Define restricciones en la complejidad de los mensajes POX que pueden ser procesados por los extremos configurados con este enlace.Defines the constraints on the complexity of POX messages that can be processed by endpoints configured with this binding. Este elemento es del tipo XmlDictionaryReaderQuotasElement.This element is of type XmlDictionaryReaderQuotasElement.
> de seguridad de <<security> Define la configuración de seguridad del enlace.Defines the security settings for the binding. Este elemento es del tipo WebHttpSecurityElement.This element is of type WebHttpSecurityElement.

Elementos primariosParent Elements

ElementoElement DescripciónDescription
<enlaces ><bindings> Este elemento contiene una colección de enlaces estándar y personalizados.This element holds a collection of standard and custom bindings.

ComentariosRemarks

El modelo de programación web de WCF permite a los desarrolladores exponer los servicios Web WCF a través de solicitudes HTTP que utilizan la mensajería de estilo "XML sin formato" (POX) en lugar de la mensajería basada en SOAP.The WCF Web Programming Model allows developers to expose WCF Web services through HTTP requests that use "plain old XML" (POX) style messaging instead of SOAP-based messaging. Para que los clientes se comuniquen con un servicio mediante solicitudes HTTP, debe configurarse un punto de conexión del servicio con el <webHttpBinding > que tenga <WebHttpBehavior > conectado.For clients to communicate with a service using HTTP requests, an endpoint of the service must be configured with the <webHttpBinding> that has the <WebHttpBehavior> attached to it.

Compatibilidad en WCF para la distribución y ASP. La integración de AJAX se basa en el modelo de programación web.Support in WCF for syndication and ASP.AJAX integration are both built on top of the Web Programming Model. Para obtener más información sobre el modelo, consulte el modelo de programación web http de WCF.For more information on the model, see WCF Web HTTP Programming Model.

Vea tambiénSee also