Compartir por

<webHttpBinding>

Define un elemento de enlace que se usa para configurar puntos de conexión para servicios web de Windows Communication Foundation (WCF) que responden a solicitudes HTTP en lugar de mensajes SOAP.

<configuración>
   <system.serviceModel>
     <Enlaces>
       <webHttpBinding>

Syntax

<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

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Attributes

Atributo Description
allowCookies Valor booleano que indica si el cliente acepta cookies y los propaga en solicitudes futuras. El valor predeterminado es false.

Puede utilizar esta propiedad cuando interactúe con los servicios web ASMX que usan cookies. De este modo, puede asegurarse de que las cookies devueltas desde el servidor se copian automáticamente en todas las solicitudes futuras de cliente para ese servicio.
bypassProxyOnLocal Valor booleano que indica si se debe omitir el servidor proxy para las direcciones locales. El valor predeterminado es false.
closeTimeout Valor TimeSpan que especifica el intervalo de tiempo proporcionado para que se complete una operación de cierre. 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 que se usa para analizar los URI. Este atributo es de tipo HostNameComparisonMode, que indica si el nombre de host se usa para llegar al servicio al buscar coincidencias en el URI. El valor predeterminado es StrongWildcard, que omite el nombre de 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 (512 * 1024). Muchas partes de Windows Communication Foundation (WCF) usan búferes. La creación y destrucción de búferes cada vez que se usan es costosa y la recolección de elementos no utilizados para los búferes también es costosa. Con los grupos de búferes, puede tomar un búfer del grupo, usarlo y devolverlo al grupo una vez que haya terminado. Por lo tanto, se evita la sobrecarga en la creación y destrucción de búferes.
maxBufferSize Entero que especifica la cantidad máxima de memoria asignada por el administrador de los búferes de mensajes que reciben mensajes del canal. El valor predeterminado es 524 288 bytes (0x80000).
maxReceivedMessageSize Entero positivo que especifica el tamaño máximo del mensaje, en bytes, incluidos los encabezados, que se pueden recibir en un canal configurado con este enlace. El remitente de un mensaje que supere este límite recibirá un error. El receptor quita el mensaje y crea una entrada del evento en el registro de seguimiento. El valor predeterminado es 65536. Nota: Aumentar este valor por sí solo no es suficiente en ASP.NET modo compatible. También debe aumentar el valor de httpRuntime (vea httpRuntime Element (ASP.NET Settings Schema)).
nombre Cadena que contiene el nombre de configuración del enlace. Este valor debe ser único porque se usa como identificación para el enlace. A partir de .NET Framework 4, los enlaces y los comportamientos no son necesarios para tener un nombre. 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.
openTimeout Valor TimeSpan que especifica el intervalo de tiempo proporcionado para que se complete una operación abierta. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00.
proxyAddress URI que especifica la dirección del proxy HTTP. Si useSystemWebProxy es true, esta configuración debe ser null. El valor predeterminado es null.
receiveTimeout Valor TimeSpan que especifica el intervalo de tiempo proporcionado para que se complete una operación de recepción. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00.
sendTimeout Valor TimeSpan que especifica el intervalo de tiempo proporcionado para que se complete una operación de envío. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00.
transferMode. Valor TransferMode que indica si el servicio configurado con el enlace usa modos de transferencia de mensajes transmitidos o almacenados en búfer (o ambos). El valor predeterminado es Buffered.
useDefaultWebProxy Valor booleano que especifica si se usa el proxy HTTP configurado automáticamente del sistema. El valor predeterminado es true.
writeEncoding Especifica la codificación de caracteres que se usa para el texto del mensaje. Entre los valores válidos se incluyen los siguientes:

UnicodeFffeTextEncoding: codificación BigEndian Unicode.

Codificación Utf16TextEncoding: codificación de 16 bits.

Utf8TextEncoding: codificación de 8 bits.

El valor predeterminado es Utf8TextEncoding.

Elementos secundarios

Elemento Description
<readerQuotas> Define las restricciones sobre la complejidad de los mensajes POX que pueden procesar los puntos de conexión configurados con este enlace. Este elemento es de tipo XmlDictionaryReaderQuotasElement.
<seguridad> Define la configuración de seguridad para el enlace. Este elemento es de tipo WebHttpSecurityElement.

Elementos primarios

Elemento Description
<Enlaces> Este elemento contiene una colección de enlaces estándar y personalizados.

Observaciones

El modelo de programación web WCF permite a los desarrolladores exponer servicios web WCF a través de solicitudes HTTP que usan mensajería de estilo "XML antiguo sin formato" (POX) en lugar de mensajería basada en SOAP. Para que los clientes se comuniquen con un servicio mediante solicitudes HTTP, se debe configurar un punto de conexión del servicio con el <webHttpBinding> que tiene el <webHttpBehavior> asociado a él.

Compatibilidad con WCF para la distribución y ASP. La integración de AJAX se basa en el modelo de programación web. Para obtener más información sobre el modelo, vea Modelo de programación HTTP web de WCF.

Consulte también

  • Last updated on